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Preface: Before You Begin 


Sourcer™ is both very powerful and straightforward to use. 
Depending on the complexity of the task you have at hand, you 
may need very little information about Sourcer to get started 
using it. The information program on the Sourcer distribution 
disk contains all the information you need to install and get 
started using Sourcer. 

To run this program, insert the Sourcer distribution diskette 
into your diskette drive, change to that drive, and enter readme. 
Then select any of the options in the menu. For example, enter 1 
for a quick introduction to Sourcer. 

Before you continue, use the information program to install 
Sourcer on your hard disk or to copy it to a backup diskette. 
Enter 2 from the main menu and then follow the instructions 
the program presents. 

When you need more information, turn to this manual. It 
contains a more detailed description of Sourcer basics and 
complete instructions for using more advanced features. 
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Chapter 1: Using Sourcer 


Sourcer is a multi-pass, commenting disassembler. It creates 
documented listings and source code directly from memory and 
from standard COM, EXE, and other binary files. In many cases 
the code that Sourcer generates looks better and is easier to read 
than the original code. There are many applications for Sourcer. 
For example, you might use it to: 

■ Clarify undocumented code. 

■ Recreate lost source code. 

■ Easily modify programs without original source code. 

■ Document programs in English. 

■ Simplify maintenance of poorly documented programs. 

■ Solve bugs in application programs. 

■ Support programs no longer supported by their publishers. 

In addition to a binary program file, you can use a definition file 
as input to Sourcer. A definition file is a text file that presets 
Sourcer options, defines memory segments, specifies comments, 
and controls data types and options for the program you are 
analyzing. For complete instructions for using definition files, 
see Chapter 4, "Using Definition Files." 


Installing Sourcer 

Use the Sourcer information program (readme) to install 
Sourcer on your hard disk or a backup diskette. To start this 
program enter the following DOS command: 

readme 
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Follow the instructions provided by the program. 


Starting Sourcer 

To start Sourcer, change to the drive and directory in which you 
installed it. At the DOS prompt, enter: 

sr 

To load a file as Sourcer starts, enter: 
sr filename 

where filename is the filename or pathname for the file you want 
to load. 

The Sourcer Main Menu appears. The top part of the Main 
Menu contains output formatting commands and four sample 
output lines. The position of the commands shows how they 
affect the output. The first letter of each command is 
highlighted. To select a command, press the keyboard key that 
matches the highlighted letter. For a description of each output 
formatting command, see Chapter 8, "Command Reference." 

The lower part of the screen contains main processing options 
and a message box. The commands in this area let you control 
how Sourcer processes a file. To select a command, press the 
keyboard key that matches the highlighted letter. The message 
box displays instructions and informational messages. 
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FI - help 


File format, list(.lst)/source(.asm) 


V COMMUNICATIONS, INC. 
Copyright (c) 1988,1989 
TM Vx.xx s/nxxxxxxx 

Analysis options 


r Output filename 

I l 

Temp.lst 

5102:0234 32 D2 

5102:0236 CD 11 
.5102:0238 0E A1E4, 


Header title 


5102:0; 


L Segment display L Word case style 
on/off 

' --- Tabs inserted on/off (ON) 


xor dl.dl 
int 11 h 
movcx, |jata_6 


Xref (cross reference) OFF 
Page 3 

; Zero register 
; Put equip bits in ax 
; (6033:A1E4=3Clh) 


Label type 
(decimal) 


T 


Remarks - all 


Input filename none 


Drive d: used for output 

Beginning addr 0000:0000 


2,613,248 bytes available 

Ending address 0000:0000 



Math off uP 8088/8086 


Code fragment Passes 2 

Select input file or address range, and any highlighted options desired. 


Loading an Input File 

To load an input file, press I from the Main Menu and then 
enter the name of the file. Sourcer loads the file, determines its 
beginning and ending addresses, determines its file type, and 
sets the processing options. 

Before processing a file, you can change the output formatting 
options or processing options. For instructions, see Chapter 3, 
"Customizing Sourcer Operation." 


Processing a File 

To process a loaded file, choose an output file format (either 
listing or source code) by pressing F until Sourcer selects the 
format you want. To specify an output filename, press O and 
enter the filename. The filename can include a drive letter and a 
path. (Don't enter a filename extension; Sourcer automatically 
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appends an extension depending on the file type.) Press G to 
begin processing the file. 

Sourcer displays progress status in the lower part of the screen. 
The following example shows status information for the 
demonstration program TESTYN.EXE. 


Input filename testyn.exe 
Beginning addr 6B44:0000 
Ending address 6B55:003D 
Math off uP 286 real 

Label Counts 
Data 6 

Sub 1 

Loc 8 

Drive c: used for output 
1,234,399 bytes available 

CodeStyle.EXE Passes 3 

Pass 3, Seg A at 6B44:0036 .|. % com plete 


The message box shows the current pass number, segment 
name, segment value, and offset. The sliding bar shows 
progress within each pass and segment. The label counts area 
shows the number of data, subroutine, and location references 
found as the analysis progresses. 

When Sourcer finishes processing the file, it writes the output 
file and quits. A listing file has the name filenamelSY where 
filename is the output filename you specified (or the name of the 
input file if you did not specify an output filename). Because the 
listing is 132 columns wide, you must view it with a viewing 
program or an editor that displays 132 columns or lets you 
scroll from left to right. For recommended programs, see 
Appendix D, "Other Useful Programs." For instructions on 
reading a listing file, see Chapter 2, "Reading a Sourcer Listing." 
A source code file has the name filename.ASM. Source code 
output is normally 80-columns wide. 

In addition to a listing or source code file, Sourcer creates a 
definition file named filename. SDF. This file contains the settings 
you used to process the file and range and reference definitions 
created by Sourcer. You can modify this file, rename it, and use 
it to process the input file again. For a complete description of 
definition files and their use, see Chapter 4, "Using Definition 
Files." 


4 Sourcer User Manual 








Chapter 1: Using Sourcer 


Quitting Sourcer 

Sourcer quits automatically when it finishes processing a file. To 
quit Sourcer at any other time, press Q or Esc. 


An Example 


The distribution diskette contains a sample test program, 
TESTYN.EXE. This program is designed to be used in a batch 
file. It checks for Y (yes) or N (no) input, and returns an error 
code 1 for Y, 0 for N, or beeps when the user presses any other 
key. The following example shows how it might be used. 


Example 1-1: Batch File ContainingTESTYN.EXE 


ECHO Do you want to system format diskette A (Y/N)? 
TESTYN 

IF NOT ERRORLEVEL1 GOTO EXIT 

FORMAT A: /S/V 

:EXIT 


You can use Sourcer to create a commented source file or a 
listing of TESTYN.EXE. On the DOS command line, enter: 

sr testyn.exe 

To generate a listing using the standard option settings, press G. 
Sourcer writes the listing to a file named TESTYN.LST. 

To generate source code instead of a listing, press F from the 
main menu to switch the file format to source code. Notice that 
the output filename extension changes and the listing 
formatting options disappear. Press G to begin processing. 
Sourcer writes the output source code to the file TESTYN.ASM. 

The distribution diskette contains a definition and a remarks file 
for TESTYN. These files add descriptive labels and comments to 
the Sourcer output. To run Sourcer using the information in 
these files enter the following command on the DOS command 
line: 


sr testyn 

When you don't supply a filename extension for an input file, 
Sourcer looks first for a definition file (with the extension .DEF). 
In this case, the definition file TESTYN.DEF instructs Sourcer to 
load TESTYN.EXE and sets the processing options. Press G to 
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process TESTYN.EXE. Then examine the output file, 
TESTYN.LST, to see how the definition file added descriptive 
labels and comments. 
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A listing file contains memory locations, hex instructions, labels, 
code, and comments. The following illustration shows a partial 
listing. 


Example 2-1: Sample Partial Listing 


Line 1 

6159:0031 

3C 6E 


cmp 

al,6Eh 

; 'n' 

2 

6159:0033 

74 08 


je 

loc_3 

; Jump if equal 

3 

6159:0035 

9A 616A: 0002 


call 

far ptr sub_1 


4 

6159:003A 

EB EB 


jmp 

short locj 


5 

6159:003C 


loc_2: 




6 

6159:003C 

B0 01 


mov 

al.1 


7 

6159:003E 

EB 02 


jmp 

short loc_4 


8 

6159:0040 


loc_3: 




9 

6159:0040 

32 CO 


xor 

al.al 

; Zero register 

10 

6159:0042 


loc_4: 




11 

6159:0042 

B4 4C 


mov 

ah, 4Ch 

;'L' 

12 

6159:0044 

CD 21 


int 

2ih 

; DOS Services ah=function 4Ch, 

13 






; terminate with al=return code 

14 

6159:0046 

000B[00) 


db 

11 dup (0) 


15 



testyn 

endp 




The first two hex words contain the segment and offset where 
the instruction appears in memory. 

Hex representations of the instructions appear next. Byte refer¬ 
ences consist of two digits, word references consist of four 
digits, double-word (dword) references consist of eight digits, 
and segment offset references consist of two sets of four digits 
with a colon separating them. In memory, the hex representa¬ 
tions occur with the low byte first. Sourcer converts the byte 
order of references to make them more readable. For example, 
line 3 in the preceding example contains the hex instructions 9A 
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616A:0002. In memory, the actual byte order is 9A, 02, 00, 6A, 
61. 

To reduce the length of listings, duplicate data items use a 
condensed format. In the hex instruction for duplicate data, the 
first word indicates the number of duplicate bytes. The 
duplicate data value, enclosed in brackets, follows it. In line 14 
of the example, the value 0 occurs 11 times. 

Occasionally extra data bytes of value 0 appear at the end of a 
segment such as in line 14 of the example. The linker inserts 
these 0-value bytes into multiple-segment programs to fill the 
bytes to the segment boundary. They do not affect the operation 
of the program, and you can remove them if you want. 

In code, Sourcer appends an h to hex numbers. Otherwise, 
numbers are decimal. The listing suppresses leading zeros in 
hex numbers except when the value of the first significant digit 
is A through F. 


Equates 


When it encounters an external data reference, Sourcer converts 
the reference to an equate and places at the beginning of the 
listing. An assembler can use the equate to recreate the same 
address when you reassemble the code. 

Sourcer appends an e to internally generated equates. When the 
program uses equate data items internally, a segment override 
tells the assembler that the item is a data reference. The 
assembler will determine whether the segment override is 
actually necessary. 


Example 2-2: Equates 


= 0044 

data_1e 

equ 

44h 

; (0000:0044=0FE23h) 

= 0046 

data_2e 

equ 

46h 

; (0000:0046=0F000h) 

= FF79 

data_3e 

equ 

0FF79h 

; (6159:FF79=0A5A5h) 

= 923E 

data_4e 

equ 

923Eh 

; (??:923E) 


In the preceding example, Sourcer created the first two equates 
because the segment used with data_1 e and data_2e was set to 
0-outside the program's range. 

The third equate in the example might occur when an indexed 
instruction has an opcode such as data_3e[si]. In this example. 
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data_3e has a value of FF79h—outside the range of this 
program. If analysis option U is off (see page 28), Sourcer 
displays index values from -64h to +64h as numbers in the 
opcode field rather than as references; they do not appear as 
equates. 

If Sourcer determines that a segment reference cannot be valid, 
it replaces the segment with ??. Such a replacement occurs, for 
example, when an instruction attempts to write into ROM. In 
that case, Sourcer uses an appropriate segment if it can deter¬ 
mine one, otherwise, it lists the segment as ??. 


Prefixes 


Prefixes are associated with instructions. Sourcer will not allow 
invalid prefixes. Nor will it allow multiple prefixes of the same 
type in a single instruction. It addition, it allows 80386 and 
80486 prefixes only when you select the 80386 or 80486 
processor. For clarity, Sourcer uses special symbols to denote 
prefixes as shown in the following table. 

Prefix Type Symbol 

Segment : 

32-bit operand and address size override 
Repeat / 

Floating point wait 

Lock > 

The following example shows several prefix instructions. 


Example 3-3: Prefixes 


Line 1 

6159:0123 

26: 89 0018 

mov 

cx,cs:data_35 

; (6159:0618=0) 

2 

6159:0127 

8D 7F 44 

les 

di,ds:data_2e(bx] 

; (0000:0144=23Dh) load 32 bit ptr 

3 

6159:012A 

FC 

cld 


; Clear direction flag 

4 

6159:012B 

F3/A4 

rep 

movsb 

; Rep while cx>0 Mov [si] to es:[di] 

5 

6159:012D 

93- D9 EB 

fldpi 


; Push Pi onto stack 


The first line contains the CS segment override prefix (26h). On 
the second line, the segment prefix is included in the opcode 
area so the assembler will handle the equate data item as a 
memory reference and not generate a segment override instruc¬ 
tion. 
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The fourth line shows a repeat prefix in the hex instruction area 
(F3h). The fifth line shows the math co-processor instruction's 
wait prefix (93h). 


Cross-references 

When the cross reference option is on and the number of passes 
is five or more, Sourcer inserts cross-reference information into 
the listing file during the final pass. Cross-references appear at 
the point where the cross-referenced item is defined making it 
easy to see which routines and functions use the referenced 
item. 

Sourcer cross-references data, locations, and subroutines. Using 
analysis options, you can turn on and off each type of cross-ref¬ 
erence. For instructions, see page 27. The following listing 
shows sample cross-references. 


Example 3-4: Cross-references 


SUBROUTINE 

Called from: 62AA:0071, 04AF, 0604,0A65,1C7E 
6093:003B, 6093:209A 



sub 23 

proc 

far 


62AA:0000 

52 

push 

dx 


62AA:0001 

BA 03C8 

mov 

dx,3C8h 


62AA:0004 

BO 03 

mov 

al,3 


62AA:0006 

loc 147: 



; xref 62AA:0013, 006B 

62AA:0006 

40 

inc 

ax 


62AA:0007 

EE 

out 

dx.al 

; port 3C8h, VGA pel address 


Cross-references to an item in the same segment always appear 
before cross-references to an item outside the segment. In the 
example, five locations within the current segment and two 
locations outside the current segment reference sub_23. Two 
items within the current segment reference the location loc_147. 

On rare occasions, Sourcer may encounter a cross-reference 
during the final pass, after writing the referenced item to the 
listing file. In such cases, the item will not have a cross-reference 
even though it is referenced. 
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A list of external references appears at the end of the listing file. 
It includes items such as the program entry point (which has the 
label start), interrupt entry points created within the program 
(typically RAM resident programs), and entry points defined by 
the optional Pre-Processor programs (such as the BIOS Pre- 
Processor). 

Use the definition file created by Sourcer, filename.SDV, to look 
up items in the listing. For a complete description of the 
definition file format, see Chapter 4, "Using Definition Files." 


Indexed Jumps and Calls 

To insure a high degree of output accuracy, Sourcer makes as 
few assumptions as possible. Clarifying indexed call and jump 
instructions, however, does require some assumptions. 

When Sourcer encounters an indexed call or jump, it uses the 
simulation data to determine the pointer value. The length and 
bounds of the index jump table are not explicitly defined, so 
Sourcer uses a separate table analyzer to determine them. 
Sourcer is usually able to accurately delineate an indexed jump 
table within 3 passes. 

The following sample listing contains an indexed call. 


Example 3-5: Indexed Call 


6159:0073 

F6 E3 


mul 

bl 

; ax = reg * al 

6159:0075 

05 0080 


add 

ax,80h 


6159:0078 

8B F0 


mov 

si,ax 


6159:007A 

FF 1C 


call 

dword ptr [si] 

;*(616F:0080=8Ch) 3 entries 

6159:007C 

B4 4C 


mov 

ah,4Ch 

; 1* 

6159:007E 

CD 21 


int 

21 h 

; DOS Services ah=function 4Ch, 






; terminate with al=return code 

6159:0080 

008C 6159 

data_1 

dw 

offset subj, seg subj 


6159:0084 

008F 6159 

data_2 

dw 

offset sub_2, seg sub_2 


6159:0088 

0092 6159 

data_3 

dw 

offset sub_3, seg sub_3 




j 


SUBROUTINE 




subj 

proc 

far 


6159:008C 

B0 04 


mov 

al,4 


6159:008E 

C3 


ret 





subj 

endp 
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Chapter 3: Customizing Sourcer 
Operation 


This chapter explains how to use Sourcer processing and 
analysis options to customize its operation. It describes how to 

■ Set the code style. 

■ Set the number of passes. 

■ Set the microprocessor filter. 

■ Set analysis options. 

■ Use command-line options. 

■ Set output options. 


Setting the Code Style 


Sourcer automatically sets the code style when you load a file. 
To change the code style, press C from the main menu until you 
see the code style you want to use. The following table describes 
code style options. 


Code style 


Description 


Fragment 


Use when analyzing only a portion of a 
program. You cannot assemble the gen¬ 
erated code. 


COM 

EXE 


Zero start 


Use for a single-segment program. 

Use for multiple-segment programs, BIOS 
ROMs, and COM files with an EXE header. 

Use for files that start at offset 0. 
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Device driver Use for files that have a device driver 

header with strategy and command entry 
points. 

Overlay Use for an overlay, starting at offset 0, to 

another program. 


Fragment Code Style 

When you choose the fragment code style, Sourcer interprets 
only explicitly referenced items as data and assumes all other 
items to be code. Use this option for files that contain program 
fragments or self-modifying code. If you use another code style 
for such a file, Sourcer interprets items not referenced within 
the program as data. 

COM Code Style 

Use COM code style for single-segment programs less than 
64 Kb in length. DOS allows programs defined as COM to have 
only one segment. However, with clever programming practice, 
a COM program can access other data segments. Sourcer 
resolves these data accesses correctly and generates a single 
segment program meeting DOS COM requirements. 


EXE Code Style 

DOS allows EXE-type programs to have one or more segments. 
However, most EXE programs use less than 4 segments. Sourcer 
supports programs that have up to 250 segments. Also use EXE 
code style when analyzing multiple segments in RAM and/or 
ROM. (You must use a definition file to analyze RAM and ROM 
segments. For instructions, see Chapter 4 "Using Definition 
Files.") 

Zero Start Code Style 

Use the zero start code style for COM-style programs that start 
with zero offset from the beginning of the file. Only a few 
internal DOS programs use this format; they typically have a 
.SYS or .BIN file extension. 
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Device Driver Code Style 

When the code style is device driver, Sourcer determines the 
special entry points for the strategy and command sections and 
creates labels that reference these sections. When you load a file 
with the extension .COM, .SYS, .DRV, or .BIN, Sourcer checks 
for the reserved device driver header. If found, Sourcer 
automatically sets the code style to device driver. 

Overlay Code Style 

If a file extension is an overlay type (for example, .OVR, .OVL, 
.OV1, and such), Sourcer sets the code style to overlay. The 
overlay style operates in the same way as the Zero Start code 
style. Overlays that contain code typically start at an offset of 
zero, but the program that calls the overlay determines its exact 
usage. The overlay can have entry points that only the parent 
program can determine as it runs, or it can contain only data for 
the parent program. 


Setting the Number of Passes 

You can instruct Sourcer to analyze your code in two to nine 
passes. Each pass improves the accuracy of the generated code. 
Five passes are usually sufficient. However, programs with 
large, indirectly addressed data areas may benefit from 
additional passes. Sourcer may interpret such data areas as code 
in earlier passes. By analyzing the code in each successive pass, 
it can determine invalid code structures and mark sections for 
conversion to data during subsequent passes. 

When the code style is set to any style other than fragment, 
Sourcer sets the number of passes to five. Program fragments 
usually require fewer passes; when the code style is set to 
fragment, Sourcer sets the number of passes to two. To set the 
number of passes, press P from the Main Menu until Sourcer 
displays the number you want. 


Setting the Microprocessor Filter 

The microprocessor filter setting determines which instruction 
set Sourcer uses. You achieve the best results by setting the 
microprocessor filter to match the microprocessor for which the 
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program you are analyzing was written. To maintain 
compatibility across computers in the PC family, most programs 
are written for the 8088. If you are not sure for which 
microprocessor the program was written, set the 
microprocessor filter to 8088/8086. 8088/8086 is the default 
microprocessor filter. Any computer can use any filter with one 
exception: Some 8088-based computers may not be able to use 
V20/V30 instruction set filter. 


Important: Using the V20/V30 instruction set filter on some 
8088-equipped machines may cause the system to halt. Some 
non-Intel 8088 parts generate a halt instruction instead of 
ignoring invalid instructions. 

To change the instruction set, press U from the Main Menu until 
the menu displays the instruction set you want. To use math 
instructions, press M until the Main Menu displays Math on. 

The following table describes each microprocessor filter. 

Filter: Description: 


8088/8086 

V20/V30 


80188/80186 


Base level instruction set. 

Similar to the 8088/8086 set. Adds some 
unique instructions and some 80186 
instructions. Unique V20/V30 instructions 
are not supported by all assemblers. Few 
programs, except those available from 
NEC, use these instructions. 

Uses 80186 instruction set. 


286 real 


Uses 80286 instruction set in real mode. 


286 protected 
386 real 


Uses the 80286 instruction set in protected 
mode (uses the entire instruction set). 

Uses 80386 instruction set in real mode. 


386 protected Uses the 80386 instruction set in protected 
mode (uses the entire instruction set). 

486 real Uses 80486 instruction set in real mode 

(includes math microprocessor 
instructions). 

486 protected Uses the 80486 instruction set in protected 
mode (uses the entire instruction set). 


The 8088/8086 instruction set is a subset of the other instruction 
sets. Sourcer supports real and protected mode 80286, 80386, 
and 80486 instructions. Most DOS programs operate in real 
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mode; real mode uses a subset of the entire instruction set. 
Protected mode uses the entire instruction set. For more 
information about the 80386 and 80486 instruction sets, see 
Appendix C, "Using 80386 and 80486 Instruction Sets." 


Setting Analysis Options 

Analysis options give you additional control over how Sourcer 
processes a file. Because the default analysis options produce 
the best results in most cases, you may only need to set analysis 
options for special needs. 

You can use analysis options to: 

■ Change the way Sourcer separates data from code. 

■ Select the assembler type (The default is Microsoft Macro 
Assembler (MASM) 5.0/5.1, Turbo Assembler (TASM), and 
OPTASM). 

■ Prevent graphics characters in output. 

■ Turn off sections of the analysis. 

■ Make selective cross references. 

To set analysis options, press A from the Main Menu. The 
Analysis Options Menu appears. In the Analysis Options 
Menu, a letter (A through Z) represents each analysis option. 
When an option is on, the letter is uppercase and highlighted. 
When an option is off, the letter is lowercase. To turn an option 
on or off, press the corresponding keyboard key. For example, 
to turn option E on or off, press E. This section describes each 
option in detail. For a summary of each option, see page 83. 

Options A through C: Inaccessible Code Areas 

Normally, Sourcer interprets inaccessible code areas as data. By 
turning on options A through C, you can instruct Sourcer to 
interpret the bytes following specific instructions as code. 
Setting the code style to fragment is similar to turning on 
options A, B, and C. For more information on code styles, see 
page 13. 
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Option A 

Turn on this option to remain in code mode instead of 
switching to data mode after a jump instruction. The following 
two examples show the results of turning on and off option A. 
The listing in Example 3-1 was produced with option A off; 
after it encounters a jump instruction that is not followed by an 
entry point (or label), Sourcer switches to data mode. The listing 
in Example 3-2 was produced with option A turned on; after the 
jump instruction, Sourcer remains in code mode-even when it 
finds no way to access the code area. (For more information 
about inaccessible code areas, see page 73). 


Example 3-1. Option A Off (Default) 


6D8C:0032 

3C6E 

cmp 

al,6Eh 

; 'n' 

6D8C:0034 

74 12 

je 

loc_3 

; Jump if equal 

6D8C:0036 

9A6D9D:0000 

call 

far sub 1 

; (6D9D:0000) 

6D8C:003B 

EBEB 

jmp 

loc 28 


6D8C:003D 

BO 01 EB 09 32 CO 

db 

OBOh, 1, 

OEBh, 9,32h, OCOh 


Example 3-2: Option A On 


6D8C:0032 

3C6E 

cmp 

al,6Eh 

; 'n' 

6D8C:0034 

74 12 

je 

loc_3 

; Jump if equal 

6D8C:0036 

9A6D9D:0000 

call 

far subj 

; (6D9D:0000) 

6D8C:003B 

EBEB 

jmp 

loc_28 


6D8C:003D 

BO 01 

mov 

al,1 


6D8C:003F 

EB09 

jmp 

|0C_4 


6D8C:0041 

32 CO 

xor 

al.al 

; Zero register 


Option B 

Turn on this option to remain in code mode instead of 
switching to data mode after a return instruction (RET). 

Option C 

Turn on this option to remain in code mode instead of 
switching to data mode after an interrupt return instruction 
(IRET). 
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Options D and E: DS and ES Values 

Normally, Sourcer sets the DS and ES simulator values to 
default values similar to the DOS defaults before disassembling 
a program. Options D and E change the default DS and ES 
values. 


Option D 

When Sourcer loads an EXE file, it sets the DS and ES simulator 
registers to the code segment less lOh. DOS does the same when 
it loads a file in order to run it. When you turn on option D, 
Sourcer sets the DS and ES defaults to the code segment. The 
following two examples show the results of turning on and off 
option D. Both show the beginning of the code. In Example 3-3, 
option D is turned off and Sourcer sets the default DS segment 
to cs-lOh. In Example 3-4, option D is turned on and Sourcer 
sets the default DS segment to the same value as the code 
segment; in this example, turning on option D links the data 
reference to the wrong point. 


Example 3-3: Option D Off (Default) 

6D8C-.0000 start: 

6D8C:0000 8B 16 0038 mov dx,data_4 ; (6D7C:0038=1 F3Eh) 


Example 3-4: Option D On 
6D8C:0000 start: 

6D8C:0000 8B 16 0038 mov dx,data_21 ; (6D8C:0038=6134h) 


Important: You must turn on option D before loading an 
EXE file. Otherwise, it has no effect. 


Option E 

Turning on option E instructs the code simulator to ignore 
changes to the DS and ES simulation registers. You can use a 
definition file to set the register values. For a complete 
description of a definition file, see Chapter 4, "Using Definition 
Files." The following two examples show the results of turning 
on and off option E. Example 3-5 shows a listing produced with 
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option E turned off. Normal simulator operation changes the 
value of DS to 40h. Example 3-6 shows a listing produced with 
option E turned on. In this case, the DS value is unchanged. As 
a result, the data reference is incorrect. You might turn on 
option E when you are analyzing self-modifying code and want 
to force the DS and ES segment registers to specific values given 
in a definition file. 


Example 3-5: Option E Off (Default) 


6D9D:0000 

8B0E0040 

mov 

cx,40h 

6D9D:0004 

0E 

push 

cx 

6D9D:0005 

IF 

pop 

ds 

6D9D:0006 

88 16 001E 

mov 

dx,keybd_queue ; (0040:001 E=0) 


Example 3-6: Option E On 


6D9D:0000 

8B 0E 0040 

mov 

cx,40h 

6D9D:0004 

0E 

push 

cx 

6D9D:0005 

IF 

pop 

ds 

6D9D:0006 

88 16 001E 

mov 

dx,data 13 ; (6D9D:001E=144Fh) 


Option F: Terminated Subroutines 

When option F is turned off, Sourcer identifies subroutines that 
do not return to the point from which they were called. After 
the call instruction, Sourcer switches from code to data mode. 
Turn on option F to prevent Sourcer from detecting such 
terminated subroutines. The following two examples show the 
results of turning on and off option F. Example 3-7 shows a 
listing produced with option F off. Because it encountered an 
invalid instruction after the subroutine call, Sourcer marks the 
subroutine as terminated. Example 3-8 shows the listing 
produced when option F is on; the subroutine is not marked as 
terminated. 


Example 3-7: Option F Off (Default) 


6A65:00F6 

8B D1 

mov 

dx.cx 

6A65:00F8 

E8 0017 

call 

sub 3 ; Sub does not return here 

6A65:00FB 

B0 07 32 DB 64 65 

db 

OBOh, 7,32h, ODBh, 64h, 65h 
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Example 3-8: Option F On 


6A65:00F6 

8B D1 

mov 

dx,cx 

6A65:00F8 

E8 0017 

call 

sub 3 

6A65:00FB 

BO 07 

mov 

al,7 

6A65:00FD 

32 DB 

xor 

bl.bi 

6A65:00FF 

64 65 

db 

64h, 65h 


Options G and H: Indexed Data Handling 

In some programs, indexed data (for example, [si+9Ah]) can 
create an incorrect data reference (in the example, at ds:9Ah). 
Such incorrect references are more likely to occur in EXE files 
than in COM files. By turning on option G or option H, you 
force these references to equates. 


Option G 

Forces indexed data references Oh to 200h to equates. Turn on 
option G instead of option H if indexed data items are 
appearing as data from Oh to 200h. 


Option H 

Forces indexed data references Oh to lOOh to equates. By default, 
option H is turned on. 

The following examples show the results of turning on and off 
option G and H. In Example 3-9, option G is off and option H is 
on; the listing references data_19 at offset 183h. In Example 
3-10, option G is on and option H is off; a simple hex offset, 

[bx+183h], replaces the data reference. In Example 3-11, both 
options are off, and all offset values are treated as data 
references. 


Example 3-9: Option G Off and Option H On pefault) 


6ED8:0077 8A 8C 0004 

mov cl,byte ptr 

|si+4] 

; (6EDB:0004=0) 

6ED8:007F 8A Af 0183 

mov ch.byte ptr 

data_19[bx] 

; (6ED8:0183=0) 


Example 3-10: Option G On and Option H Off 


6ED8:0077 

8A 8C 0004 

mov cl.byte ptr 

[si+4] 

; (6EDB:0004=0) 

6ED8:007F 

8A Af 0183 

mov ch.byte ptr 

[bx+183h] 

; (6ED8:0183=0) 
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Example 3-11: Option G and Option H Off 


6ED8:0077 

8A 8C 0004 

mov cl.byte 

ptr 

data_2[si] 

; (6EDB:0004=0) 

6ED8:007F 

8A Af 0183 

mov ch.byte 

ptr 

data_19[bx] 

; (6ED8:0183=0) 


Option I: Graphics Characters 

Turning on option I prevents Sourcer from using graphics 
characters in the output file. Turn on this option when your 
printer does not support the graphics characters. The following 
two examples show the result of turning on and off option I. 


Example 3-12: Option 1 Off (Default) 





SUBROUTINE 

beeper 

proc far 


Example 3-13: Option I On 





SUBROUTINE 

beeper 

proc far 


Option J: Interrupt Vector Entry Points 

Turn on option ] to prevent Sourcer from detecting interrupt 
vector entry points into the program. Example 3-14 shows a 
listing produced with option J off. The simulator detects the 
loading of an interrupt vector and generates a procedure label 
for the interrupt. 
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Example 3-14: Option J Off (Default) 


6F84:000A 

int_36hjBfitfy 

proc 

far 

6F84:000A 50 


push 

ax 

6F84:000B BO 02 


mov 

al,2 


6F84:0141 

BA 

000A 

mov 

dx.OAh 


6F84:0144 

B8 

2536 

mov 

ax,2536h 


6F84:0147 

CD 

21 

int 

21 h 

; DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 

6F84:0149 

B8 

0040 

mov 

ax,40h 



Option K: Absolute Location References 

Turn on option K to prevent Sourcer from writing absolute 
location reference comments for jumps and calls. The following 
two examples show the results of turning on and off option K. 
In Example 3-15, option K is off and the listing contains 
comments to show the destination of calls and jumps. In 
Example 3-16, option K is on and the listing does not contain 
such comments. 


Example 3-15: Option K Off (Default) 


6D8C:0036 9A 6D9D:0000 

call 

far ptr beeper 

; (6D9D:0000) 

6D8C:003B EB EB 

jmp 

short begin_program 

; (0028) 


Example 3-16: Option KOn 


6D8C:0036 

9A 

6D9D:0000 

call 

far ptr beeper 

6D8C:003B 

EB 

EB 

jmp 

short begin_program 


Option L: RETF and RETN Instructions 

Turn on this option to prevent Sourcer from using the 
instruction mnemonics RETF/RETN for return far and near. 
Turn on this option if you are using MASM version 4.0 or 
another assembler that does not support RETF and RETN. The 
following two examples show the results of turning on and off 
option L. 
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Example 3-17: Option L Off (Default) 


6D9D:002B CB 


retf 


: return far 


Example 3-18: Option L On 


6D9D:002B CB 


ret 


: return far 


Option M: MASM 4.0 Compatibility 

Turn on this option if you intend to reassemble the generated 
code with MASM 4.0. For certain instructions, code originally 
assembled with MASM 4.0 (or an earlier assembler) uses two 
bytes where MASM 5.0 (and later assemblers) use only one 
byte. When option M is off, Sourcer checks for these old-style 
instructions and preserves the number of bytes in the original 
file by inserting NOP instructions. When option M is on, 

Sourcer does not fix the old-style instructions. The following 
two examples show the result of turning on and off option M. In 
Example 3-19, option M is off and Sourcer inserts a NOP 
instruction that was not in the original code. Without the NOP 
instruction, all newer assemblers will produce an instruction 
that uses one byte less than the original program. The NOP 
instruction insures that the reassembled program has the same 
number of bytes as the original program. In Example 3-20, 
option M is on, and Sourcer does not insert a NOP instruction. 


Example 3-19: Option M Off (Default) 


F000:8830 81 0E 0415 0008 

or 

chan_io_size_,8 

; (0000:0415=80h) 


nop 


;*Fixup for MASM (M) 


Example 3-20: Option M On 


F000:8830 81 OE 0415 0008 


chan_io_size_,8 


; (0000:0415=80h) 


Option N: ASSUME Statements 

Turn on this option to prevent Sourcer from placing extra 
ASSUME statements in code to insure reassembly. By default. 
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this option is turned off. The following two examples show the 
results of turning on and off option N. In Example 3-21, option 
N is off (normal operation), and Sourcer inserts the ASSUME 
statements necessary for reassembly. In Example 3-22, option N 
is on, and Sourcer does not insert ASSUME statements. Without 
the ASSUME statements, the generated code may not 
reassemble properly. 


Example 3-21: Option N Off (Default) 


F000:814E 

33 CO 

xor 

ax,ax 

; Zero register 

F000:8150 

8E D8 

mov 

ds.ax 



assume 

ds:seg_a 


F000:8152 

FF 2E 0467 

jmp 

dword ptr @gen_io_ptr_ 

; (0000:0467=3) 


Example 3-22: Option N On 


FOOO:814E 

33 CO 

xor 

ax,ax 

; Zero register 

F000:8150 

8E D8 

mov 

ds.ax 

F000:8152 

FF 2E 0467 

jmp 

dword ptr @gen_io_ptr_ 

; (0000:0467=3) 


Option O: Indexed Jumps and Calls 

Turn on this option to prevent Sourcer from analyzing indexed 
jump and indexed call instructions. By default, this option is 
turned off. The following two examples show the result of 
turning on and off option O. In Example 3-23, option O is off 
and Sourcer performs its normal analysis of indexed jumps and 
calls. In Example 3-24, option O is on and Sourcer does not 
make any indexed jump or call linkages nor does it create a 
table of offsets. 


Example 3-23: Option O Off (Default) 


6A65:613F 

FF A4 6147 


jmp 

word ptr data_5[si] 

;*(6A65:6147=614Fh) 3 entries 

6A65:6143 


loc_3: 




6A65:6143 

B4 4C 


mov 

ah,4Ch 


6A65:6145 

CD 21 


int 

21 h 

; DOS Services ah=function 4Ch 






; terminate with al=return code 

6A65:6147 

61 4F 

data_5 

dw 

offset loc_4 

; Data table (indexed access) 

6A65:6149 

61 57 

data 6 

dw 

offset loc_5 


6A65:614B 

61 64 

data 7 

dw 

offset loc_6 
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Example 3-24: Option O On 

6A65:613F 

FF A4 6147 

jmp word ptr data_5[si] 

;*(6A65:6147=614Fh) 

6A65:6143 

loc_3: 



6A65:6143 

B4 4C 

mov ah,4Ch 


6A65:6145 

CD 21 

int 21 h 

; DOS Services ah=function 4Ch 




; terminate with al=return code 

6A65:6147 

61 4F data 5 

dw 614Fh 

; Data table (indexed access) 

6A65:6149 

57 61 4B 61 

db 57h.61h.4Bh, 61 h 



Option P: Index Register 

When option P is turned off (the default), Sourcer ignores the 
index register value when it is less than 180h. Turn on this 
option to use any value in the simulation index register (BX, BP, 
SI, or DI) for indexed jumps and calls. Only in very rare cases 
do you need to turn on option P. The following two examples 
show the result of turning on and off option P. In Example 3-25, 
option P is off and Sourcer correctly identifies the table at 
data_5. In Example 3-26, option P is on and Sourcer builds the 
table at data_5+si. The resulting code incorrectly references the 
table at 613F+23h (6162h). 


Example 3-25: Option P Off (Default) 


6S65:613C 

BE 0023 


mov 

si,23h 


6A65:613F 

FF A4 6147 


jmp 

word ptr data_5[si] 

;*(6A65:6147=614Fh) 3 entries 

6A65:6143 


loc_3: 




6A65:6143 

B4 4C 


mov 

ah,4Ch 


6A65:6145 

CD 21 


int 

21 h 

; DOS Services ah=function 4Ch 






; terminate with al=return code 

6A65:6147 

614F 

data_5 

dw 

offset loc_4 

; Data table (indexed access) 

6A65:6149 

6157 

data_6 

dw 

offset loc_5 


6A65:614B 

6164 

data 7 

dw 

offset loc 6 









Example 3-26: Option P On 


6S65:613C 

BE 0023 

mov 

si,23h 


6A65:613F 

FF A4 6147 

jmp 

word ptr data_5[si] 

;*(6A65:6147=614Fh) 1 entry 

6A65:6143 

loc 3: 




6A65:6143 

B4 4C 

mov 

ah,4Ch 


6A65:6145 

CD 21 

int 

21 h 

; DOS Services ah=function 4Ch 





; terminate with al=return code 

6A65:6147 

614F data 5 

dw 

614Fh 

; Data table (indexed access) 

6A65:6149 

57 61 4B 61 

db 

57h, 61 h, 4Bh, 61 h 
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Options Q through T: Cross-references 

Options Q through T set cross-reference options. Turning on 
Xref in the Main Menu turns on options Q, R, and S. 

Option Q 

Turn on this option to cross-reference all data references. 


Option R 

Turn on this option to cross-reference all location references. 
The following two examples show the result of turning on and 
off option R. 


Example 3-27: Option R Off 


6D8C:003D 

6D8C:003D 

BO 01 

loc_2: 

mov 

al,1 


6D8C:003F 

6D8C:0041 

EB 02 

loc_3: 

jmp 

short exit 

; (0043) 

6D8C:0041 

32 CO 


xor 

al.al 

; Zero register 


Example 3-28: Option R On 


6D8C:003D 


loc_2: 



; xref 6D8C:0030 

6D8C:003D 

BO 01 


mov 

al,1 


6D8C:003F 

EB 02 


jmp 

short exit 

; (0043) 

6D8C:0041 


loc_3: 



; xref 6D8C:0034 

6D8C:0041 

32 CO 


xor 

al.al 

; Zero register 


Option S 

Turn on this option to cross-reference all subroutine references. 

Option T 

Turn on this option to prevent Sourcer from cross-referencing 
locations that are less than 128 bytes away from each other. 
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Option U: Indexed Data Values 

Turn on option U to prevent Sourcer from interpreting indexed 
data values -64h through +64h as offsets. When option U is on, 
Sourcer creates data references. In most cases, numbers from 
-64h to 64h are adjustments to an index and creating a data item 
in low memory may obstruct code in the same area. The 
following two examples show the result of turning on and off 
option U. 


Example 3-29: Option U Off (Default) 

F000:8731 C6 44 11 F2 mov byte ptr [si+11 h),0F2h 


Example 3-30: Option U On 

F000:8731 C6 44 11 F2 mov data_2[si],0F2h 


Option V: Near Jump Fixup 

Turn on option V to prevent Sourcer from fixing near jumps. 
Some older assemblers use a near jump (3 bytes) where they 
could have used a short jump (2 bytes). When option V is 
turned off, Sourcer inserts a NOP after the jump. The resultant 
code, if reassembled on a newer assembler, maintains the same 
number of instruction bytes as the original code. 

Option W: Warning Comments 

Turn on option W to prevent Sourcer from adding warning 
comments to the output file. Sourcer inserts a warning comment 
when it detects an indexed jump or call, identifies a register 
jump or call, or inserts a fixup instruction (see option M on page 
24. Warning comments begin with a semicolon and an asterisk 
(;*). If you plan to reassemble the code, you should check each 
line marked with a warning comment. For more information, 
see Chapter 7, "Reassembling Generated Source Code." The 
following two examples show the result of turning on and off 
option W. 
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Example 3-31: Option W Off (Default) 

6A65:613F FF A4 6147 jmp word ptr data_5[si] 

;*(6A65:6147=614Fh) 3 entries 

Example 3-32: Option W On 


6A65:613F FF A4 6147 jmp word ptr data_5[si] 

; (6A65:6147=614Fh) 3 entries 


Option X: Final Pass References 

When option X is turned on, Sourcer creates references during 
its last pass as it writes the file to disk. References created 
during the last pass usually become undefined when the code is 
reassembled. By default, option X is turned off. The following 
two examples show the result of turning on and off option X. In 
Example 3-33, the last pass did not define loc_27. Sourcer 
converts loc_27 into equivalent data bytes so that the code can 
be reassembled and inserts a warning comment. When you 
encounter such a comment, try disassembling the code again 
using more passes or check whether the area is actually code. 
Also, some compilers produce code with invalid jumps that 
never execute. 


Example 3-33. Option X Off (Default) 


F000:8140 

E9 2101 ;* 

jmp 

loc 27 

;* 

F000:8140 

E9 01 21 

db 

0E9h, 1,21h 


F000:8144 

33 ED 

xor 

bp,bp 

; Zero register 


Example 3-34. Option X On 


F000:8140 

E9 2101 

jmp 

loc_27 


F000:8144 

33 ED 

xor 

bp.bp 

; Zero register 
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Command Line Options 

You can set additional Sourcer features when you start Sourcer 
from the DOS command line. Use the following format to set a 
command line option: 

sr option option ... 

where option is one of the command line options described in 
the following table. 

Option Description 

-d Do not look for a system defaults definition 

file. For more information, see Chapter 5, 
"Setting System Defaults." 

filename Specifies the file to load during startup. If 

you do not provide a filename extension, 
Sourcer tries to locate the file in the current 
directory by appending the following 
filename extensions, in order: JDEF 
(definition file), .EXE, and .COM. If it 
cannot find the file, it starts without loading 
a file. 

-n Process display information through the 

DOS interrupt instead of writing directly to 
the screen. Use this option when your 
system does not support one of the IBM 
display standards. 

-sxxxx Changes the video segment to xxxx where 

xxxx is a 4-digit hex number. Use this 
option when your system does not support 
one of the IBM display standards and the 
video buffer is set to a value other than 
BOOOh or B800h. If you use the -N option, 
Sourcer ignores this option. 

-v Prevents Sourcer from using VGA/EGA- 

specific features and from changing the 
color palette. Use this option if your system 
has an EGA or VGA card and screen 
problems occur while using Sourcer. 

For example, to run Sourcer with the file TESTYN.EXE, ignoring 
the system defaults, on a system that does not have an IBM- 
standard display, enter: 
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sr testyn.exe -d -n 

You can preset the command line options by setting the DOS 
environment variable VCOM. For example, to prevent Sourcer 
from using EGA/VGA features enter: 

set vcom = -v 

To permanently set this environment variable, include a 
command such as the preceding one in your AUTOEXEC.BAT 
file. 


Setting Output Options 

To control the format of the output file, you can use Main Menu 
output formatting commands, analysis options, and definition 
file options. In addition, you can write an output file directly to 
a printer. This section describes how to set output options. 

Output Formatting Commands 

Output formatting commands appear in the upper portion of 
the Main Menu along with four sample output lines that show 
their effect. The available output options change when you 
change the output file format. For a description of each 
command, see page 81. 

Analysis Options for Output 

Analysis option I lets you turn on and off graphics characters in 
the output file. Turn off this option to use graphics characters, 
and turn it on to prevent Sourcer from using graphics 
characters. For a complete description of on analysis option I, 
see page 22. 

Definition File Output Options 

The Vertical lines option in a definition file gives you additional 
control over output format. It lets you change the number of 
lines per page and the page width in output files. For a 
complete description of the Vertical lines definition file option, 
see page 41. 
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Writing the Output File to a Printer 

To write the Sourcer output file directly to your printer instead 
of to disk, load the file to process and then change the output 
filename to PRN. 
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Definition files let you preset Sourcer commands and options, 
define multiple memory segments, add your own comments to 
generated code, and control data types and options for the pro¬ 
gram you are analyzing. A definition file is a text file with a 
special format. This chapter explains how to create and use 
definition files. It describes how to: 

■ Use the definition file format. 

■ Use definition files generated by Sourcer. 

■ Use the template definition file: SAMPLE1.DEF. 

■ Load a definition file. 

■ Specify control information in section one. 

■ Specify range definitions in section two. 

■ Specify reference definitions and comments in section three. 


Definition File Structure 

Each definition file contains a control information section, a 
range definition section, and a reference definition section. The 
control information section (section one) presets Main Menu 
commands and analysis options. The range definition section 
(section two) defines segment ranges. The reference definition 
section (section three) defines and labels code items and assigns 
comments to them. 

In each section, data lines begin with a non-space character in 
column one and comment lines begin with a space in column 
one. At least one comment line separates sections, and the refer¬ 
ence definition section can have comments between entries. 
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Sourcer ignores all comment lines when it processes the 
definition file. The following example shows an abbreviated 
version of the file TESTYN.DEF. 


Example 4-1: TESTYN.DEF 




SOURCER DEFINITION FILE - 

TESTYN 


Section 1 

CONTROL INFORMATION 

UP 

= 8088 



Input filename 

= testyn.exe 


Header 

= TESTYN with definition file 


Xref 

= ON 




; Section 2 RANGE DEFINITION || 

begin end default 

seg seg 


seg:off off 

ds es 

type size 


none 



; comments in this area ignored 

! 

Section 3 REFERENCE DEFINITIONS 




seg:off 

type & options 

label 

comments 

seg_c:0000 

sub, far, c 02 

beeper 

; beep subroutine (3rd segment) 

■_ - 1 nrotinnc - 



seg:off 

type & options 

label 

comments 

seg_a:0028 

loc, c 04 

begin_program 


seg_a:0043 

loc 

exit 





seg:off 

type & options 

label 

comments 

seg_c:002C 

da, r 0C 

yes_no_message 


seg_c:0038 

dw,c6 

speaker_port 


seg_c:003A 

dw,c7 

on.offjime 


seg_c:003C 

dw,c 8 

beep_cycles 
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Using Definition Files Generated by Sourcer 

Each time you run Sourcer, it creates a definition file containing 
all command and option settings, segment range definitions, 
and all locations, subroutines and other items that it identified. 
A Sourcer-generated definition file uses the standard definition 
file format. It has the output filename you specified and the 
extension .SDF. 

You may want to use a Sourcer-generated definition file as the 
basis for your own file. For example, you might want to edit it 
to add your own labels and comments to the code. To use a 
Sourcer-generated definition file as input to Sourcer, you must 
change its name so it has a filename extension of .DEF. 

For example, you might start Sourcer, load the file 
MYPROG.EXE, specify a listing output file with the name 
MYPROG.LST, and then generate the listing. In addition to the 
listing file, Sourcer creates the definition file MYPROG.SDF. To 
create an input definition file from MYPROG.SDF, copy it to a 
file with the .DEF filename extension. For example: 

copy myprog.sdf myprog.def 

Edit MYPROG.DEF to add your own labels and comments to 
the definition file. 

The optional Pre-Processor programs also create definition files 
to use as input to Sourcer. 


Using the Template Definition Files 

The SAMPLE! .DEF and SAMPLE2.DEF files (on the Sourcer 
distribution disk) are templates for your definition files. 
SAMPLE1.DEF contains comments that divide sections and 
describe the format for each section. SAMPLE2.DEF is similar to 
SAMPLE1.DEF except that it contains fewer descriptive 
comments. To create your own definition files, copy one of these 
template files and edit the copy. 


Loading a Definition File 

To load a definition file, include the definition file name in the 
command you use to start Sourcer. For example: 

sr testyn.def 
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You do not need to supply the .DEF filename extension. 
However, all definition files must have a .DEF extension. 

If the definition file does not specify an input filename and you 
want to use one, press I from the Main Menu and enter a 
filename. When you load the input file, Sourcer asks which 
segment ranges to keep. Press 1 to only keep only the segments 
for the new file, press 2 to keep both the segments for the new 
file and the segments defined in the definition file, or press 3 to 
keep only the definition file segments. No matter which option 
you choose, Sourcer uses the labels from the definition file. It 
also creates references as needed when they are not supplied in 
the definition file. 


Specifying Control Information in Section One 

The first section of a definition file contains control information 
that presets commands and options. 

Each line in this section assigns a value to a command or option 
using the format: 

control_option = value 

where control_option is one of the predefined options for this 
section and value is the value assigned to it. (Not all options 
have values.) You can abbreviate a control option by using its 
shortest unique form; Sourcer ignores other characters until it 
encounters the equal sign. 

If a definition file contains no control information, the control 
information section must contain the following line: 

none 

Control Options 

This section describes (in alphabetical order) each of the pre¬ 
defined control options and its possible values. 


Analysis options = 

Sets analysis options. List all analysis options you want to 
preset after the equal sign. Use uppercase to turn on an option 
and lowercase to turn off an option. For a detailed description 
of the analysis options, see Chapter 3, "Customizing Sourcer 
Operation." For example, to turn on options A, B, C, and G and 
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turn off options N, X, and Y, use the following line in your 
definition file: 

analysis options = ABCGnxy 
Begin segment = 

Specifies the memory location at which to load an input file. Use 
this option to make sure that the input file loads at the same 
location each time you process it. Its value must be a 4-digit hex 
number and must be equal to or greater than the location that 
Sourcer would normally use (if you loaded the file without 
using this option). To determine the beginning segment for EXE 
files, subtract lOh from the location at which you want the code 
to begin. For example: 

Begin segment = 97F0 


Code style = 

Specifies the code style. Its value can be one of the following 
styles: COM, EXE, fragment, overlay, zero start, or device 
driver. For a complete description of code style options, see 
page 13. For example, to set the code style to EXE, use the 
following line in your definition file: 

code style = exe 

If you specify an input filename in your definition file, it must 
precede the code style. 


Drive = 

Sets the disk drive for output. Its value can be any disk drive 
letter from A to Z. For example, to write the output files to 
drive C, use the following line in your definition file: 

drive = c 


File format = 

Sets the output file format. Set it to ASM for source code or LST 
for a listing. (LST is the default.) For example, to generate 
source code, use the following line in your definition file: 

file format = asm 
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Go 

Instructs Sourcer to begin disassembling the input file 
immediately after loading the definition file. This option lets 
you run Sourcer in a batch mode. If the output file exists, 
Sourcer will still ask whether it is ok to overwrite the file. 


Header = 

Specifies a header text string (up to 32 characters long) for the 
listing. If used, this option must appear after the Input filename 
option. For example: 

Header = Test run number 2 
Input jfilename = 

Names the input file. You can specify a drive and/or a complete 
pathname. The process of loading an input file automatically 
sets other options. Thus, the following options must appear 
after Input filename option in the definition file: 

■ Code style 

■ Header 

■ Output filename 

■ Passes 

■ Xref 

For example, to load the file named TESTYN.EXE, use the 
following line in your definition file: 

input filename = testyn 
Keep segments = 

In special cases, you can force Sourcer to use selected segment 
ranges. The following table shows possible values. 

Value: Description: 

FILE Use segments from the input file only. 

DEF Use segments from the range definition 

section of the definition file only. 

BOTH Use segments from both the input file and 

the definition file. This value is the default. 
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In most cases, leave Keep segments set to its default of BOTH. 
Sourcer will automatically resolve differences between the 
segments specified when a file is loaded and any entries in the 
range definition section of the definition file. When you use the 
Keep segment option, it must precede the Input filename 
option. 

Regardless of the Keep segments value, Sourcer sets the seg_a to 
seg_z type segment variables when loading a file. You can use 
these variables throughout the definition file. For more 
information about segment variables, see page 43. 

For example, to use segments from the range definitions section 
of the definition file only, use the following line: 

keep segments = def 


Label type = 

Specifies the label type. The following table shows possible 
values and an example of their output: 


Value: 


Example: 


decimal data_123 

zero fill data_0123 

segment & offset d_7B23_08AB 
letter seg & offset data_c_08AB 
The default label type is decimal. 


For example: 

Label type = letter seg & offset 


Math on 

Instructs Sourcer to use the math coprocessor instruction set 
(8087, 80287, or 80387). The 80486 microprocessor has math 
capabilities built in. When you set the processor type to 80486, 
Sourcer automatically supports 80486 math instructions. 


Output filename = 

Specifies the output filename. You can specify a drive and/or a 
complete pathname. You do not need to supply a filename 
extension; Sourcer appends either .LST (for a listing file) or 
.ASM (for a source code file) to the filename you specify. If you 
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do not specify an output file name in the definition file, Sourcer 
uses the definition file name and appends to it the extension 
.LST or .ASM. For example: 

output filename = temp3 


Passes = 

Sets the number of passes. Its value can be any number from 2 
to 9. For example: 

passes = 4 


Remarks = 

Sets the type of automatic comments to include in the output 
file. The following table lists and describes possible values. 

Value: Description: 


all 

except data 
except interrupt 
except others 
data 

interrupt 

others 

none 


Show all comments. 

Show all comments except data value 
comments. 

Show all comments except interrupt and 
I/O comments. 

Show only data, interrupt, and I/O 
comments. 

Show only data value comments. 

Show only interrupt and I/O comments. 

Show all comments except data, interrupt, 
and I/O comments. 

Show no automatic comments. 


For example, to include all comments except data value 
comments, use the following line in your definition file: 

remarks = except data 


Segment display off 

Turns off the display of segments in the listing file. Omit this 
option to display segments. 
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Tabs off 

Instructs Sourcer to output spaces instead of tabs. Unless this 
option appears in the definition file, Sourcer uses tabs. 


uP = 

Selects the a microprocessor instruction set. Possible values are 
8088, V20/V30, 80186, 80286, P80286 (protected mode), 80386, 
P80386, 80486, P80486, AUTO, and MAX. AUTO sets the 
instruction set to the microprocessor on which Sourcer is 
running. MAX operates the same as AUTO, but uses protected 
modes. The default is 8088. For example: 

up = P80846 


Vertical lines = 

Sets the number of lines per page and the width compression 
for listings. The default number of lines per page is 59. You can 
specify any number from 10 to 255. Set this option to 0 to 
suppress page breaks and page headers in listings. 

Listings usually require 132 columns to show hex information, 
code, and comments. 80-column printers may require you to 
use a condensed printing mode. Laser printers may require you 
to print in landscape mode or to print using a character set that 
allows 132 columns per line. Consult your printer manual for 
the proper setup. 

Using the Vertical lines option, you can set one of four levels of 
width compression. The following table describes each level. 

Characters Per Line 


Level 

ASM File 

LST File 

cO 

100 

132 

cl 

92 

124 

c2 (the default) 

84 

116 

c3 

76 

108 


Tabs must be ON to allow compression. (See page 41.) For 
example, a definition file might contain one of the following 
lines: 

Vertical = 76 
Vertical = 59, c3 


Sourcer User Manual 41 



Chapter 4: Using Definition Files 


Word upper 

Specifies uppercase characters in output. Omit this option to use 
lowercase characters. 


Xref = 

Turns cross-references on or off. Turning cross-references on 
sets the number of passes to 5. For example, use the following 
line to turn on cross-references: 

Xref = on 

Control Information Example 

The following example shows a control information section. 


Example 4-2: Control Information 



Section 1 CONTROL INFORMATION liilil.' 

Analysis options 

= B 

UP 

= 8088 

Input filename 

= testyn 

Code style 

Tabs off 

= exe 

Xref 

= on 


This example turns on analysis option B, sets the 
microprocessor instruction set to 8088/8086, and loads the file 
TESTYN.EXE. It also sets the code style to EXE, turns off tabs, 
and turns on cross-references. 


Specifying Range Definitions in Section Two 

The second section of a definition file defines ranges of bytes for 
Sourcer to process. In addition to specifying the beginning and 
ending bytes in a range, the definition file also specifies the 
range's default DS and ES segments, its segment type, and its 
size. A definition file can contain a maximum of 250 ranges 
(including segments generated by loading a file, see page 38 and 
"Segment Variables," next). 

You can use range definitions to analyze ROM or RAM areas, to 
redefine a loaded file's environment, or to divide a single seg¬ 
ment into data and code areas. Use range definitions to identify 
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32-bit and 16-bit segments when using an 80386 or 80486 micro¬ 
processor filter. 

Segment Variables 

When Sourcer loads an input file from a definition file, it identi¬ 
fies up to 250 segments and loads the segment values into vari¬ 
ables. You can use segment variables in place of numeric 
segment values anywhere in the definition file. The segment 
variables let the definition file be independent of the memory 
locations in which the program is actually loaded. The segment 
variable labels always match those used in the listing. Sourcer 
assigns variable names to segments in the order that it 
encounters them. It uses the following naming scheme. 

Segment Order Variable Name 

1st segment through 26th segment seg_a to seg_z 

27th segment through 52nd segment seg_aa to seg_zz 

53rd segment through 78th segment seg_ba to seg_bz 


235th segment through 250th segment seg_ia to seg_io 

For a list of segment variable abbreviations used by earlier 
releases of Sourcer, see page 102. 

Range Definition Entries 

Each entry in the range definitions section defines a single 
range. It consists of a single line containing the following items: 

■ Beginning segment and offset. 

■ Ending offset. 

■ Default DS and ES values. 

■ Segment type. 

■ Optional segment size (either 16 or 32 bits). 

■ Optional comments (ignored by Sourcer). 
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The sample definition files and the definition file templates, 
SAMPLE1.DEF and SAMPLE2.DEF, contain header comments 
that label the components of a range definition. Range 
definitions can appear in any order. If your definition file 
contains no range definitions, it must contain the following line 
in section two: 

none 

This section describes each component of the range definition. 


Beginning Segment and Offset 

The beginning segment and offset defines the beginning of the 
range. 


Ending Offset 

The ending offset is the last byte in the range. If Sourcer pro¬ 
cesses an instruction near or at the end of a range, it includes in 
the range all bytes required for that instruction, even if the 
range extends beyond the ending offset you specified. 

Default DS & ES 

The default DS and ES values are the values of the DS and ES 
registers at the beginning of the range and at any external entry 
points within the range. Set these values to 0000 for data and 
stack ranges. 


Segment type 

You can assign to a range any one of the following segment 

types. 

Type Description 

AUTO Range contains both code and data. Sourcer 

will fully resolve references. (Used in most 
cases unless other types are specified.) 

CODE Range contains code. Unless items are 

directly referenced as data elsewhere in the 
input file, Sourcer identifies them as code 
within the CODE range. 

DATA Range contains data only. Sourcer does not 

process the range as code. 
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STACK Range contains a stack. Sourcer does not 

process the range as code. 

RAUTO Range contains code and data in ROM. 

Sourcer treats the range the same as an 
AUTO type range, except that it detects 
attempts to write into the range and marks 
them as a bad data segment access. 

RCODE Range contains code in ROM. Sourcer treats 

the range the same as a CODE type range, 
except that it detects attempts to write into 
the range and marks them as a bad data 
segment access. 


Segment Size 

You can specify either a 16-bit or a 32-bit segment size for the 
range by setting the segment size to either USE16 (for a 16-bit 
segment) or USE32 (for a 32-bit segment). If you do not specify a 
segment size, Sourcer assumes the size is USE16. 


Comments 

You can enter comments in the final column. Each comment 
must begin with a semicolon (;). Range definition comments do 
not appear in the output file. 

Range Definition Example 

The following example shows a range definitions section. 


Example 4-3: Range Definitions Section 


begin 

end 

default 

seg 

seg 


seg:off 

off 

ds 

es 

type 

size 


0040:0000 

00FF 

0000 

0000 

data 

use16 

; BIOS data area 

seg_a:0000 

0009 

seg a 

seg a 

code 

use16 

; beginning of program (code) 

seg_a:000A 

0026 

0000 

0000 

data 

use16 

; program (data) 

seg_a:0027 

0051 

seg a 

seg a 

code 

use16 

; program (code) 

seg_b:0000 

0179 

0000 

0000 

stack 

use16 

; program's stack area 


The first range defines the data area used by the BIOS. The 
segment type specifies data only. For data ranges, the default 
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DS and ES have no meaning, so you should set them both to 

0000. 

The next three ranges are all within the first segment, repre¬ 
sented by the segment variable seg_a. (Sourcer determines seg¬ 
ments when it loads the input file.) When ranges are 
consecutive within the same segment, Sourcer does not generate 
extra ORG statements at the range boundaries. The example 
predefines the code and data areas rather than allowing Sourcer 
to automatically determine them. 

The last segment range uses the second segment (seg_b) and 
defines the size of the stack (180h bytes). 


NOTE: If it has loaded a file, Sourcer compares the range 
definitions you specified in the definitions file with the ranges 
it established when it loaded the program. If there are any 
overlaps, it uses the ranges defined in the definition file. Use 
the Keep segments control option (described on page 38) to 
control handling of range definitions. 


Specifying Reference Definitions in Section Three 

The reference definition section lets you define the components 
of the input file by creating specific references to data, locations, 
or subroutines. You can use it to 

■ Add descriptive labels to code. 

■ Set data items to a specific type and length. 

■ Force items to be data or code. 

■ Identify external entry points. 

■ Insert your own comments in the code. 

■ Fine tune a Sourcer output file. 
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Reference Definition Entries 

Each one-line entry in the reference definition section defines a 
single reference. A reference consists of the following items: 

■ Segment and offset. 

■ Item type. 

■ Reference options. 

■ Reference label (optional). 

■ Comment (optional). 

Reference definitions can appear in any order. However, to 
avoid duplicate entries, we recommend ordering them by seg¬ 
ment and offset. All values should be in hex. If your definition 
file contains no reference definitions, it must contain the 
following line in section three: 

none 

The sample definition files and the definition file templates, 
SAMPLE1.DEF and SAMPLE2.DEF, contain header comments 
that label the components of a reference definition. This section 
describes each component of the range definition. 


Segment and Offset 

The segment and offset is the absolute location of the referenced 
item. If the control information section of the definition file 
loads the input file, you should use segment variables instead of 
hex values for segments. For a complete description of segment 
variables, see page 43. 


Item Type 

Assign one of the following types to the item (the last three 
types have abbreviations in addition to their standard labels). 


Type: 

Description: 

DB 

Data byte. 

DW 

Data word. 

DD 

Double word. 

DA 

ASCII data byte (text). 
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DS Data structure. See the example on page 53. 


SUB Subroutine reference. 

LOC Location reference. 

FORCED Forced function. 

Each item type has its own set of reference options. 

Data Options. The reference definition for a data item can 
specify one or more of the following data options. 

Option; Description: 

, C xxx 

Insert comment; xxx is a hex number from 1 
to 3FF and references a comment stored in a 
separate remarks file. 

, DUP 

Duplicate bytes or words. Use only with DB 
or DW types. 

,EQU 

Force the data reference to an equate (DW 
type only). 

, INDEX 

Replace an index with the associated label. 
See the example on page 53 for its usage. 

, MULTI 

Multiple defined label. Code generated 
using this option will not reassemble. 

The following DW type options specify an offset to another ref¬ 
erence: 

, OSN 

Offset Subroutine Near 
( dw offset sub_xxx) 

, OSF 

Offset Subroutine Far 
( dw offset sub_xxx, seg sub_xxx) 

, OLN 

Offset Location Near 
( dw offset loc_xxx) 

, OLF 

Offset Location Far 
( dw offset loc_xxx, seg loc_xxx) 

, ODN 

Offset Data Near 
( dw offset data_xxx) 

, ODF 

Offset Data Far 

(dw offset data_xxx, seg data_xx) 

, R xxxx 

Repeat the data type xxxx times, where 
xxxx is a number from 1 to FFFFh (the 
default is 1). For example, dw, R 4 indicates 
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, UNUSED 

, SEG 

8 bytes. If text data (type DA) has no R xxxx 
option, Sourcer automatically sets the 
length of the text to the first dollar sign ($) 
or 0 it finds. 

If item is never referenced, then do not use. 

Use segment name as value (DW type 
only). 

(dw seg_b) 


Location Options. A reference definition for a location item can 
specify one or more of the following options. 


Option: 

Description: 

, C XX 

Insert comment where xx is a hex number 
from 1 to FF representing a comment in a 
separate remarks file. 

, EXT 

Create an external entry point into the pro¬ 
gram. Sourcer resets the simulation 
registers to 0 and sets the DS, ES, and SS 
segments to their default values. 

, FAR 

Create a far procedure and reset simulation 
registers to 0. Sets DS, ES, and SS to their 
defaults. 

, NEAR 

Create a near procedure and reset simula¬ 
tion registers to 0. Sets DS, ES, and SS to 
their defaults. 

, UNUSED 

If item is never referenced, do not use it. 


Subroutine Options. A reference definition for a subroutine 
item can specify one or more of the following options. 


Option: 

Description: 

,Cxx 

Insert comment where xx is a hex number 
from 1 to FF representing a comment in a 
separate remarks file. 

, FAR 

Define subroutine as FAR. If not specified, 
Sourcer automatically determines whether 
the subroutine is near or far based on 
usage. 

, TERM 

Subroutine terminates (it does not return to 
caller). After each call to the subroutine, 
Sourcer switches to data mode. 
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, UNUSED If item is never referenced, then do not use 

it. 

Forced Function Options. Use the following options to specify 
forced functions. 


Option: 

Description: 

, CODE 

Switch to code mode without changing 
segment size. 

, CODE16 

Switch to 16-bit code mode and change 
segment size to 16 bits. Sourcer remains in 
16-bit code mode until the end of the 
segment or until encounters a CODE32 
option. 

, CODE32 

Switch to 32-bit code mode and change 
segment size to 32 bits. Sourcer remains in 
32-bit code mode until the end of the 
segment or until encounters a CODE or 
CODE16 option. The microprocessor 
instruction set should be 80386 or 80486 to 
use CODE32. 

, DATA 

, ENDP 

Switch to data mode. 

Force an ENDP instruction to appear after 
this instruction if inside a subroutine or 
major procedure. 

, AX-xxxx 

Change the value of a simulation register to 
xxxx (a 4-digit hex value). You can use this 
option to set the following 16-bit simulation 
registers: AX, BX, CX, DX, BP, SI, DI, 
SP, DS, ES, or SS. 

, EAX=xxxxxxxx 

Change the value of a simulation register to 
xxxxxxxx (an 8-digit hex value). You can 
use this option to set the following 32-bit 
simulation registers: EAX, EBX, ECX, 
EDX, EBP, ESI, EDI. 

, EAx 

Selects LEA instruction's reference item 
type. By default, Sourcer selects an absolute 
number (LEA DI,DS:[234h]). Use this 
option to select a different reference. It has 
the following forms: 

EAS - for subroutine. 

EAL - for location. 
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EAD - for data. 

To use a segment other than the current 
one, you can append a segment value (See 
the example on page 56). 

, Ox Converts immediate value to offset at the 

referenced instruction. This option has the 
following forms: 

OS - for offset to subroutine. 

OL - for offset to location. 

OD - for offset to data item. 

To use a segment other than the current 
one, you can append a segment value (See 
the example on page 56). 

, REG Displays all internal simulation registers. 

The following options control forced table analysis for indexed 
call and jump instructions. 


, SN Table offset sub_xx 

, SF Table offset sub_xxx, seg sub_xxx 

, LN Table offset loc_xx 

, LF Table offset loc__xxx, seg loc_xxx 

Use the format seg_a:xxxx f, sn 1234:22 34 where 1234:22 is 
the position of the subroutine table with 34h entries. 


Label Field 

In this optional field, you can enter a label up to 15 characters 
long. Do not enter a comma before the label or include a comma 
within it. Forced functions ignore the label field. 

If you do not enter a label, Sourcer ignores the remainder of the 
line. Thus you cannot enter comments for unlabeled items in the 
definition file. You can, however, enter comments for unlabeled 
items in a remarks file. (See Chapter 6, "Adding Comments to 
the Output File.") 


Comment Field 

In this field, you can enter a short comment (64 characters or 
less). Your comment appears in listings when the item is 
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defined. If a semicolon appears in the comment, Sourcer ignores 
the remainder of the line. Type a semicolon at the beginning of 
comments that you want to appear only in the definition file. 

Forced functions ignore the comment field. 

Reference Definition Examples 

The examples in this section show how to use the data reference 
section. 


Simple Data References 

The following example shows how to create simple data 
references. 


Example 4-4: Data References 


seg:off 

type & options 

label 

comments 

0000:0020 

dw, Unused 

vector_8h_off 


0000:0022 

dw, Unused 

vector_8h_seg 


0040:001 E 

dw, R10 

keybd_buffer 

; 16 words (lOh) 

0040:0049 

db 

videojnode 

Current video mode 

seg_c:0025 

dw, C 4E 

speaker_port 

; Comment #4E 


In the example, the first two data items reference the interrupt 8 
vector offset and segment. The type is set to word (DW), and the 
item will be removed if it is never referenced or used within the 
program. 

The third and fourth items reference the BIOS data area. The 
keyboard buffer is comprised of 16-word entries (1 Oh). The 
video mode is a single byte. The comment Current video mode 
appears where the video mode is defined in Sourcer output 
files. 

The fifth item, speaker_port, is a data word in the third segment 
of the loaded program at an offset of 25h. In listings, comment 
number 4Eh from the associated remarks file appears where the 
item is defined. For more information on remarks files, see 
Chapter 6, "Adding Comments to the Output File." 
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Special Data Items and Options 

The following example explains the usage of special options 
and more complex data functions. 


Example 4-5: Special Data Items and Options 


Line 

seg:off 

type & options 

label 

comments 


1 

o 

seg_c:0006 

dw, 

Index 

index_six 



Jj 

3 

seg_c:0200 

ds, 

R 3 


; Data Structure (3 times) 


4 


dw 


handle 

; 1 word 


5 

6 


da, 

ROC 

filename 

; 12 character string 


7 

8 
9 

seg_c:0224 

dw, 

OSF 

sub_pointer 

; Offset to a subroutine 


seg_c:0228 

db, 

DUP.R8 

temp_buffer 

; Duplicate bytes 


10 







11 

0000:0449 

db, 

Multi 

video_mode 

; Multi-defined 


12 

0040:0049 

db 


video_mode 

; Primary definition 



The first item overrides an index value of 6 in the third segment. 
References of the type [si+6] will appear as index_six[si]. This 
function is primarily used with a Pre-Processor. At location 6, 
the item index_six will be defined as an equate rather than a 
data word. 

The third line defines a structure that repeats 3 times. A data 
structure can contain any number of data items within the same 
segment up to a total of 64 Kb. The structure in the example 
contains a single word (line 4) and an ASCII string of 12 
characters (line 5). The structure concludes when Sourcer 
encounters a blank line or another segment and offset in 
column 1. 

Line 7 indicates the data item is a pointer to a far subroutine. 
Line 9 creates duplicate data bytes, 8 bytes long. Sourcer does 
not check whether the bytes are identical, but lists only the first 
byte as duplicated. 

The following listing section shows the result of using the 
definition file example with a program. Note how the data 
structure expands into 3 sets of data. 
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Example 4-6: Sample Program Listing 


6159:0200 

0005 



handle 

dw 

5 

6159:0202 

74 65 73 74 

61 

32 

filename 

db 

'testa100.com' 


31 31 2E 63 

6F 

6D 




6159:020E 

0006 



handlel 

dw 

6 

6159:0210 

74 65 73 74 

61 

33 

filenamel 

db 

1esta200.com' 


31 31 2E 63 

6F 

6D 




6159:021 C 

0000 



handle2 

dw 

0 

6159:021 E 

00 00 00 00 

00 

00 

filename2 

db 

0 , 0 , 0 , 0 , 0,0 


00 00 00 00 

00 

00 


db 

0 , 0 , 0 , 0 , 0,0 

6159:0224 

07FA6159 



sub_pointer 

dw 

offset sub 23, seg sub 23 

6159:0228 

0008[FF] 



temp_buffer 

db 

8 dup (OFFh) 


Location References 

The next example shows how to define location references with 
descriptive labels. 


Example 4-7: Location Items 


seg:off 

type & options 

label 

comments 

seg_a:0030 

loc 

begin_program 


seg_a:0422 

loc, FAR 

int_9_keyboard 

; Far procedure 

seg_a:053E 

loc, C1E 

error_handler 

; Comment# IE 


The first entry is typical of most location references. It defines a 
label begin_program in the first segment at offset 30h. The 
second item int_9_key board uses the FAR option to indicate that 
the reference is a far procedure and to reset Sourcer's internal 
simulator. The last line references the location comment number 
lEh in the associated remarks file. In a listing, the comment 
appears before the label. (For more information on using the 
remarks file, see Chapter 6, "Adding Comments to the Output 
File.") 
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Subroutine References 

The next example defines subroutine references. 


Example 4-8: Subroutine References 


seg:off 

type & options 

label 

comments 

seg_a:10E2 

sub 

clear_buffer 


seg_a:119B 

sub, Far 

beep_once 

; Far subroutine 

seg_a:133D 

sub, Far, C 24 

boopjwice 

; Far & use comment 24 

seg_a:1C71 

sub, TERM 

out_string 

; Terminated subroutine 


Most subroutine references use a format similar to the first 
entry. Sourcer automatically determines whether the subroutine 
is near or far based on usage. The second entry forces the sub¬ 
routine to be defined as a far procedure. The third entry 
combines the FAR option and the COMMENT option. In 
listings, comment 24h appears in the subroutine header block. 

The last entry uses the TERM function to define a terminated 
subroutine. When Sourcer encounters a call to a terminated 
subroutine, it indicates that the subroutine will not return to the 
next instruction and switches from code to data mode. 

The following example shows part of the listing generated from 
the reference definitions in Example 4-8. On the first line, it 
shows a subroutine defined as terminated. 


Example 4-9: Terminated Subroutine 


6A65:00E2 

E8 

168F 

call 

out_string ; (1C71) Sub does not return here 

6A65:00E5 

43 

6F 

70 79 72 69 

db 

'Copyright (c) 1988,1989', 0 

6A65:00EB 

67 

68 

74 20 28 63 



6A65:00F1 

29 

20 

31 39 38 38 



6A65:00F7 

2C 

31 

39 38 39 00 



6A65:00FD 




locjl: 


6A65:00FD 

8B 

D1 


mov 

dx.cx 
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Forced Functions 

The following example shows the use of forced functions. 


Example 4-10: Forced Functions 


Line 

seg:off 

type & options label 

comments 

1 

seg_a:0CB1 

forced, code 

; Force to code mode 

2 

seg_a:0D22 

forced, data 

; Force to data mode 

3 

A 

seg_a:0D9A 

forced, endp 

; Indicate end procedure 

** 

5 

seg_a:0FF6 

forced, ds=seg_c 

; set DS to 3rd segment 

6 

seg_a:16C9 

forced, es=40 

; set es to 40h 

7 

8 
9 

seg_a:1CD5 

forced, registers 

; display registers 

seg_a:1714 

forced, eas 

; LEA ptr to subroutine 

10 

seg_a:188C 

forced, ealseg_c 

; LEA ptr to location 

11 




12 

seg_a:1AB8 

forced, od 

; immediate to offset data 

13 

seg_a:1C32 

forced, osFOOO 

; immediate to sub offset 

14 




15 

seg_a:1E97 

forced, snseg a:32 2 

; sub near index table 

16 

seg_a:1 F92 

forced, lf1234:4C2 0 

; location far index table 


The first entry sets the system to process code at location 
se g_a ; CB1 . The second line forces the system to process data at 
seg_a:D22. The third line issues an ENDP directive after the 
instruction at seg_a:D9A. 

The fifth and sixth lines set the DS and ES simulation registers. 
You can use this function to change an incorrect simulation 
register. Use an entry similar to the seventh line to show the 
contents of the simulation registers in the listing. 

The LEA instruction opcode at seg_a:171 4 is set to a 
subroutine. If a subroutine does not exist in the same segment, 
Sourcer creates one. The tenth line specifies that the LEA 
instruction at seg_a:188c should reference a location in the 3rd 
segment (seg_c). 

When an immediate word occurs in most instructions, Sourcer 
cannot determine whether the word is a value or an offset to 
another reference. Sourcer treats the immediate word as a value. 
This practice allows accurate reassembly as long as bytes are not 
added or deleted before the referenced item. Lines 12 and 13 
convert the immediate value into an offset. The instruction at 
seg_a:1 AB8 has an immediate field. The entry at line 12 
converts the field to an offset of a data item relative to the CS 
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segment. The next entry converts the immediate field at the 
instruction seg_a:1 C32 to an offset of a subroutine, relative to 
the FOOOh segment. 

The last two entries demonstrate the forced index function. 
When Sourcer cannot automatically determine whether an 
indexed jump or call instruction requires it to determine a table 
of pointers, this function forces it to create a table of pointers. 
The example first specifies the type of table (sn, sf. In, or If). Next 
it gives the segment:offset of a table of pointers. Finally, it pro¬ 
vides the number of entries in the table (1 to FFh). If you use a 
value of 0, Sourcer determines the number of table entries. 

Forced Function Indicator 

The listing file denotes forced functions by inserting a period 
between the instruction offset and the hex instruction code. If a 
forced function was specified in the definition file but a period 
does not appear in the listing, the function was not used. 

Sourcer does not use a forced function if it is inappropriate or if 
the definition file entry contained the wrong segment:offset 
address. 

The second line in the following example shows a forced 
function in a listing file. 


Example 4-11: Forced Function 


62AA:0000 

52 

push 

dx 

62AA:0001 

.BA03C8 

mov 

dx, offset loc_234 
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The file SDEFAULT.DEF contains default settings for Sourcer 
Main Menu commands and analysis options. You can edit this 
file to customize Sourcer defaults. 

SDEFAULT.DEF is a definition file (for a complete description 
of the definition file format, see Chapter 4, "Using Definition 
Files.") Sourcer uses it only if you do not specify another 
definition file when you start Sourcer. After starting Sourcer, 
you can use the Main Menu commands to change settings. 

The control information section (section one) in the 
SDEFAULT.DEF file presets Sourcer Main Menu commands 
and analysis options. For information on setting options in this 
section, see page 36. The range definition section does not apply 
to an SDEFAULT.DEF file. It must contain the single line: 

none 

The reference definition section (section three) of the standard 
SDEFAULT.DEF file contains labels for commonly used BIOS 
values. These entries are used only if the input program 
references BIOS data items. Only referenced data items appear 
in the Sourcer-generated definition file (SDF file). 

The following example shows part of the standard 
SDEFAULT.DEF file. 
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Example 5-1: SDEFAULT.DEF File 


-1 cm lorco nccAi n t nctriMiTinM cn c 1- 


•V-Section 1: CONTROL INFORMATION 

input filename = ? (? = use command line entry if provided) 

Confirm 0- DAMOC HCCIMITIOM • 

\ '•■V; s 

begin 

end default seg 

seg 


seg:off 

off ds 

es type 

size 


none 

Cortinr 

, q. RPFFRFMr.F T 

DEFINITI 

Qfyjg 


i o. ncrcnciNuc i 



seg.off 

type & options 

label 


comments 





seg:off 

type & options 

label 


comments 





seg:off 

type & options 

label 


comments 

0040:0000 

dw, Unused 

@rs232_port_1 


; Start of primary BIOS RAM 

0040:0002 

dw, Unused 

@rs232_port_2 


; These entries are optional and 

0040:0004 

dw, Unused 

@rs232_port_3 


; will only show up if referenced 

0040:0006 

dw, Unused 

@rs232_port_4 


; by the program under analysis 

0040:0008 

dw, Unused 

@prn_port_1 



0040:000A 

dw, Unused 

@prn_port_2 




When you start Sourcer without specifying a definition file, it 
loads the SDEFAULT.DEF file in the current directory. If there 
is no SDEFAULT.DEF file, it uses settings preset in the program 
without issuing a warning message. If you need to use different 
sets of Sourcer defaults, you can create SDEFAULT.DEF files in 
different directories or on different disks. 

To start Sourcer without using SDEFAULT.DEF from a di¬ 
rectory that contains an SDEFAULT.DEF file, use the following 
command: 

sr -d 
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Output File 


Using definition files, you can insert comments into the Sourcer 
output file. Each comment is associated with a specific data, 
location, or subroutine reference item in the definition file's ref¬ 
erence definition section. Comments appear in listings and in 
source code files. Depending on the type of item it references 
and the method you used to specify a comment, it either 
appears to the right of the referenced item or immediately 
before the referenced item. 

There are two ways to associate comments with a data, location, 
or subroutine reference. The easiest way is to include the com¬ 
ments in a reference definition entry in the definition file. Use 
this method for comments that are 64 characters (the maximum 
allowed) or less in length. The following example shows a 
comment associated with a data reference using this method. 
The comment in line 4, Current video mode, appears to the right 
of the data reference in the output file. The comment on line 3 
does not appear in the output file. Sourcer ignores any 
characters after a semicolon in a definition file line. 


Example 6-1: Definition File Comment 


seg-.off 

type & options 

label 

comments 

0000:0020 

dw, Unused 

vector_8h_off 


0000:0022 

dw, Unused 

vector_8h_seg 


0040:001 E 

dw, R10 

keybd_buffer 

; 16 words (lOh) 

0040:0049 

db 

video_mode 

Current video mode 


If a comment is longer than 64 characters, you can store it in a 
remarks file associated with the definition file. All comments in 
the remarks file are numbered. You use the comment number to 
associate it with a data, location, or subroutine reference in the 
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definition file. The following example adds one line to the pre¬ 
vious example. The code C 4E in the last line links the data 
reference to a comment in the associated remarks file. 


Example 6-2: Remarks File Comment 


seg:off 

type & options 

label 

comments 

0000:0020 

dw, Unused 

vector_8h_off 


0000:0022 

dw, Unused 

vector_8h_seg 


0040:001 E 

dw, R10 

keybd_buffer 

; 16 words (lOh) 

0040:0049 

db 

video_mode 

Current video mode 

seg_c:0025 

dw, C 4E 

speaker _port 

; Comment #4E 


You can use both commenting methods with a single input file. 
Sourcer checks the definition file first. If the definition file con¬ 
tains a comment for a particular item, it does not use the 
remarks file comment for that item. 


Using a Definition File to Add Comments 

The easiest way to add a comment is to include it in the 
definition for a data, location, or subroutine reference in the 
reference definitions section (section three) of the definition file. 
For more information about adding comments to definition 
files, see Chapter 4, "Using Definition Files." Data and location 
comments specified in the definition file appear to the right of 
the referenced item in output files. Subroutine comments 
appear before the subroutine reference. 


Using a Remarks File to Add Comments 

When comments are longer than 64 characters, you must store 
them in a remarks file. The remarks file must reside in the same 
disk and directory as the corresponding definition file. It must 
have the same filename as the definition file with the extension 
.REM instead of .DEF. A remarks file consists of three sections-- 
one for each type of comment. 

The file TESTYN.REM is a sample remarks file for use with the 
demonstration definition file TESTYN.DEF and the input file 
TESTYN.EXE. You may want to examine this file as you create 
your own remarks files. 


62 Sourcer User Manual 








Chapter 6: Adding Comments to the Output File 


Data Remarks Section 

The data remarks section contains comments associated with 
data items. Each comment must begin with a three digit hex ref¬ 
erence number, followed by a space and then the comment text. 
Comment reference numbers can range from 001 to 3FF (for a 
total of 1023 comments). Comments can consist of multiple 
lines. However each line cannot consist of more than 34 charac¬ 
ters. The following line must conclude the data remarks section: 

end 

The following illustration shows a sample data remarks section. 


Example 6-3: Data Remarks Section 
-Data Remarks- 

001 This is remark number 1 
002 This remark continues onto three 
lines, with the 2nd & 3rd lines 
indented 2 spaces 


Lines starting with a graphics 
character will be placed prior 
to the line that the data item 
comment appears on. 

A line feed will automatically 
be placed prior to and after 
the graphics character area. 


this line is left of data item 3 
end 


The Location Remarks Section 

The location remarks section contains comments associated 
with location items. In the output file, location comments 
appear before the location label. Sourcer automatically inserts a 
line feed before the comment. If you want a line feed to occur 
after the comment, you must include it as part of the comment 
in the remarks file. 

Each comment in the location remarks section must begin with 
a two-digit hex reference number, followed by two spaces and 
then the comment text. Comment reference numbers can range 
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from 01 to FF (for a total of 255 comments). Comments can 
contain graphics characters and consist of multiple lines. 
However, each line cannot consist of more than 76 characters. 
The following line must conclude the location remarks section: 

end 

The following illustration shows a sample location remarks sec¬ 
tion. 


Example 6-4: Location Remarks Section 

-Location Reference Remarks- 

01 This is a location reference remark 

02 ■ - | GRAPHICS | - 

■ All graphics characters are allowed for special highlighting 

■ Line feeds can be inserted for extra clarity 

03 Text of each remark begins in column 5 in this file 
end 


Subroutine Remarks Section 

The subroutine remarks section contains comments associated 
with subroutine items. In the output file, subroutine comments 
appear before the subroutine procedure. Sourcer automatically 
inserts a line feed before the comment. If you want a line feed to 
occur after the comment, you must include as part of the com¬ 
ment in the remarks file. If the subroutines uses the standard 
header, Sourcer inserts the comment into the header. 

Each comment in the subroutine remarks section must begin 
with a two-digit hex reference number, followed by two spaces 
and then the comment text. Comment reference numbers can 
range from 01 to FF (for a total of 255 comments). Comments 
can contain graphics characters and consist of multiple lines. 
However, each line cannot consist of more than 76 characters. 
The following line must conclude the subroutine remarks sec¬ 
tion: 

end 

The following illustration shows a sample subroutine remarks 
section. 
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Example 6-5: Subroutine Remarks Section 

-Subroutine Reference Remarks- 

01 TESTA SUBROUTINE 

02 BEEPER SUBROUTINE 

This subroutine generates a short beep. Note that the sound and 
duration are uP speed dependent. 


Registers used: al.bx.cx.dx.ds 
end 


Remarks File Notes 

■ Each remark can consist of up to 64,000 characters. 

■ The maximum remarks file size is the smaller of 32 Mb or 
64,000 lines. 

■ Sourcer automatically inserts a semicolon before a comment 
in an output file; you do not need to include the semicolon 
in the comment text in the remarks file. 

■ To create a blank line with no semicolon, enter a return 
without characters on or before column 3. If Sourcer detects 
any characters (including a single space), it writes a semi¬ 
colon to the output file. 
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Source Code 


This chapter gives tips for: 

■ Generating code that is most compatible with a given 
assembler. 

■ Checking a generated source file before reassembling it. 

■ Correcting reassembly errors. 

■ Changing generated source code. 


Generating Code for Assembler Compatibility 

Different assemblers generate code that is functionally the same. 
However, the actual instructions used may vary. The 8086 fam¬ 
ily of processors have a number of instructions that perform the 
same task, but use different opcodes. Some assemblers don't 
always use the most compact instruction. 

The following examples compare code produced by MASM 4.0 
and MASM 5.1. 


Example 7-1: MASM 4.0 Code 
612A:0123 81 E3 0030 and bx,30h 


Example 7-2: MASM 5.1 Code: 

612A:0123 83 E3 30 and bx,30h 
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MASM 4.0 produces a valid instruction, but does not use the 
most compact form. MASM 5.0 and 5.1, however, use a more 
compact instruction to perform the same function. In these 
examples, the same instruction produces different results. In 
addition, there is no way to instruct the assembler to reassemble 
code in exactly the same way that it was assembled or compiled. 

Sourcer has two automatic fixup routines that insure the same 
functional operation as the original code by maintaining the 
same number of bytes assembled. Sourcer cannot insure the 
assembler you are using will create a program that is identical 
byte-for-byte with the original program. The remainder of this 
section describes assemblers that have been tested with Sourcer 
and gives recommended options for each one. For a complete 
description of Sourcer analysis options, see Chapter 3, 
"Customizing Sourcer Operation." 

Microsoft Macro Assembler (MASM) version 4.0 or 
earlier 

When generating code to be reassembled with MASM 4.0 (or 
earlier versions), turn on Sourcer analysis options L and M. If 
the original program was assembled with a later version of 
MASM or another optimizing compiler and you disassemble it 
using MASM 4.0 settings, Sourcer produces code that may have 
more bytes than the original. If the original source code had 
both far and near returns in the same procedure, MASM 4.0 
cannot reassemble it. MASM 4.0 and earlier versions do not 
support unique 80386/80387 or 80486 instructions. Contact 
Microsoft to upgrade to a later version of MASM for a nominal 
fee. 


Microsoft Macro Assembler (MASM) versions 4.5 
and later 

When disassembling code created with MASM version 4.5 or 
later, leave analysis options L, and M off (the default settings). 
Sourcer uses MASM features to produce phase locked code. 
MASM 5.1 has several bugs that may make it impossible to 
reassemble the code if it was not originally assembled using 
MASM 5.1. MASM 5.1 and earlier versions do not support 
unique 80486 instructions. 
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Turbo Assembler (TASM) 

When disassembling code generated with TASM, leave analysis 
options L and M off (the default settings). Sourcer uses features 
of this assembler to produce phase locked code. When 
reassembling Sourcer-generated code with TASM, use the 
TASM option for compatibility with MASM 5.1 (default TASM 
operation). TASM 1.0 does not support unique 80486 
instructions. 

OPTASM versions 1.0 and 1.5 

When reassembling Sourcer-generated code, use the OPTASM 
/m command line option (for MASM-compatible code). This 
option turns off optimizations that can change the phase lock by 
using more compact instructions than the original code. Use this 
option even if the Sourcer input file was originally created with 
OPTASM. OPTASM 1.0 and 1.5 do not support unique 
80386/80387 and 80486 instructions. 

A86 version 3.0 and later versions 

To generate code for assembly with A86, turn on Sourcer analy¬ 
sis option L. This assembler is not fully compatible with 
Sourcer output. A86 may report errors that you'll have to fix by 
editing the generated source code. Also, A86 uses different op¬ 
codes from other assemblers that are functionally the same. 
Thus, it is difficult to compare the original and A86-generated 
hex files. A86 does not support unique 80286/80287, 
80386/80387, and 80486 instructions. 


Reassembly Checklist 

Sourcer was designed to make reassembly easy and relatively 
trouble-free. However, Sourcer must make some assumptions 
as it analyzes an input file. As a result there are some things you 
should check before reassembling a generated file. In addition, 
some warnings or errors may occur when you reassemble the 
file. 

Everyone has different objectives when reassembling generated 
code. For example, if you need to thoroughly understand a pro¬ 
gram and plan to make extensive modifications, it may take 
more work to reassemble it. If a specific problem exists and a 
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minor patch will fix it (for example, changing bytes to NOP 
instructions or changing a specific instruction), you may be able 
to skip some of the steps described in this section. 

Sourcer automatically inserts an asterisk (*) on lines where it 
made assumptions that could cause reassembly problems. Use 
an editor or list program, to search for ;* to examine each poten¬ 
tial problem. It is usually easier to examine problems when the 
listing contains cross-references. (For instructions on including 
cross-references in the listing, see page 10.) 

The remainder of this section list specific problems for which 
you should check and gives recommended solutions. 

Indexed Jumps and Calls 

Sourcer automatically builds a data table for referenced calls 
and jumps. In a few cases, Sourcer's internal simulation may not 
link to the correct table. The most common indicator of this 
problem is a comment that indicates only one entry. For 
example: 


Example 7-3: Incorrect Table 

call dword_ptr data_123 [BX] ;* (63A2:078E =(0CDh) 1 entry 


Check that the table appears valid, and that the proper number 
of entries were found. If necessary, use a definition file to 
replace Sourcer's automatic analysis with forced table analysis. 
Use the SN (sub near), SF (sub far), LN (loc near), and LF (loc 
far) options. (See page 50.) The automatic analysis stops after 50 
entries to prevent possible errors from creating a very large 
table. 

Register Jumps and Calls 

To learn the destination of a register jump or call, you must 
analyze previous code. In some cases the original program may 
contain a table of jumps or calls instead of using an indexed 
jump or call. An instruction preceding the jump or call loads the 
address into the register (see the following example). However, 
without having encountered the subsequent register jump or 
call, Sourcer may interpret the address as data. 


70 Sourcer User Manual 




Chapter 7: Reassembling Generated Source Code 


Example 7-4: Register Jump 

mov 

cx,90Eh 

jmp 

cx 


To change an immediate value to an offset to the desired refer¬ 
ence, make a definition file entry that points to the beginning of 
the instruction (in the example, mov cx,9DEh). Use the forced 
function code OL for a jump and OS for a subroutine. 

If the program sets up a data table, you can set the entries in the 
table to offsets to the jump locations or subroutines. Use a defi¬ 
nition file entry that points to the beginning of the table. Define 
the data words as offsets to the locations or subroutines. For 
example to define a table of xx location offsets, use the codes: 

DW, OLN, R xx Table_start 

For a table of subroutine offsets, use OSN in place of OLN. 

Immediate Fields within an Instruction 

Sourcer may not determine whether an immediate field within 
an instruction is simply a numeric value or an offset to a data, 
subroutine, or location reference. An immediate field could also 
be an offset to a data item in another segment (in which case the 
current segment register is unrelated to the instruction 
containing the immediate field). The binary file does not contain 
information specifying the use of the immediate field. The 
following example shows an immediate field. 


Example 7-5: Immediate Fields 
mov si,1C24h 


If you reassemble the file and the instructions remain in the 
same position as the original code, you will have no problems 
with immediate fields. Sourcer has several methods of insuring 
that the instructions remain in the same position. However, if 
you modify the generated code you may need to determine 
whether each immediate field is an offset or offset type (data, 
location, or subroutine) and in which segment the item resides. 

You can use a definition file to force an immediate value into an 
offset. If the item is not in the same segment as the instruction, 
include the segment in the definition file entry. Use the forced 
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function codes OS, OL, and OD. For their description, see 
page 50. 

Incorrect Code or Data Determination 

Although the binary file does not distinguish code from data, 
Sourcer's multiple-pass method of disassembling a file usually 
results in a very accurate determination of code and data items. 

Occasionally, code appears as data or data appears as code in a 
generated file. A section of data might happen to look like code, 
or code might be referenced as data (as is self-modifying code). 
Unless you plan to modify the generated file, you may not need 
to correct such problems. 

To correct inaccurate code and data designations, you can use a 
definition file to force an area of the program to be data or code 
only. (See the following instructions.) You can also set the code 
style to fragment or turn on analysis options A through C to 
change some data areas to code. (See page 17.) 


Using Segment Ranges to Specify Data and Code Areas 
In the range definitions section (section two) of a definitions file, 
you can specify a range of bytes to treat as data or code. For 
example, the definition file for the program TESTYN.EXE might 
have the following ranges defined. (In this case, Sourcer does 
not need the range definitions in order to accurately handle the 
data and code ranges. They are shown as an example only.) 


Example 7-6: Definition File, Section 2 


begin 

end 

default 

seg 

seg 


seg:off 

off 

ds 

es 

type 

size 


seg_a:0000 

0001 

seg a 

seg a 

code 

use16 

; first jump instruction is code 

seg_a:0002 

0026 

0000 

0000 

data 

use16 

; forced data area 


Since the two segment ranges are contiguous, Sourcer treats 
them as a single segment with forced code and data sections. 


Specifying Forced Data Areas 

You can also use data references in section three of the defini¬ 
tion file to specify data items. When Sourcer encounters a single 
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data reference at the beginning of a data area, it remains in data 
mode until it encounters a location label or subroutine. 

Example 7-7 shows a line that specifies a data area beginning 
with a data byte at offset 2. Example 7-8 shows a line that speci¬ 
fies a data area without including a label or setting a specific 
type of data. 


Examples 7-7: Data Type and Label 


seg:off 

type & options 

label 

comments 

seg_a:0002 

db 

data_start_area 



Example 7-8: Forced Data 

seg:off 

type & options label 

comments 

seg_a:0002 

forced, data 



Specifying Forced Code Areas 

Use a location label or forced function code to switch back to 
code mode. The following examples show two ways to force the 
file back to code mode at offset 27h. 


Example 7-9: Location Reference 


seg:off 

type & options 

label 

comments 

seg_a:0027 

loc 

begin_code 



Example 7-10: Forced Function 


seg:off 

type & options label 

comments 

seg_a:0027 

forced, code 



Inaccessible Code 

When an area of code is never accessed, Sourcer assumes it is 
data. Code that was originally produced by a compiler some- 
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times has inaccessible (and unnecessary) code fragments. The 
better the compiler is at optimizing, the fewer inaccessible code 
fragments there will be. 

External Entry Points 

Sourcer normally determines external entry points into a pro¬ 
gram. The file type (and the EXE and device driver file header) 
provides external entry point information. In special cases, 
Sourcer cannot determine entry points from the input file. You 
must predefine the entry points, or Sourcer cannot accurately 
process the file. For example, disassembling a BIOS requires 
predefined entry points. The optional BIOS Pre-Processor 
program, available from V Communications, predefines BIOS 
entry points for you. 

Terminate and Stay Resident (TSR) programs also require pre¬ 
defined entry points. When installed, TSR programs create 
additional external entry points to interlink the system inter¬ 
rupts. Sourcer's internal simulator can detect these entry points 
if they are created through the standard DOS interface. Sourcer 
generates a special label to indicate interrupt entry points; it has 
the format int_xxh_entry where xxis the interrupt number. If a 
TSR program doesn't use the DOS convention, Sourcer won't be 
able to determine external entry points. 

When Sourcer is unable to determine entry points, you can pre¬ 
define them in a definition file. The predefined external entry 
points can also create a near or far procedure, if necessary. Pre¬ 
defined interrupt vectors from TSR programs, for example, 
should include a far procedure call. The following example 
shows a far procedure entry point definition. 


Example 7-11: Entry Point 


seg:off 

type & options 

label 

comments 

seg_a:0422 

loc, far 

int_9_keyboard 

; Far procedure 


Reassembly Errors 

Even if you carefully prepared the generated code file, some 
errors may occur during reassembly. If many errors occur, most 
of them are probably caused by a few key problems. This sec- 
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tion suggests actions you can take to correct the most common 
errors. 

Block Nesting Errors 

Sourcer correctly identifies procedures and subroutines in 
modular programs and (in most cases) non-modular programs. 
In some cases, it is impossible to correctly define the endpoint of 
a procedure. For example, a subroutine that does not exit or that 
jumps into a previous subroutine may fail to have a properly 
placed end of procedure (ENDP) statement. An assembler will 
generate an error for such a subroutine. You must manually 
insert an ENDP statement at the correct point in the source code 
file or specify a forced ENDP function at the correct point in the 
definition file and disassemble the code again. 

Syntax Error (RETN/RETF) 

MASM version 4.0 and older assemblers do not support the 
RETN and RETF instructions. Rerun Sourcer with analysis 
option L turned on. 

Phase Errors Between Passes 

Phase errors are difficult to debug, because an error message 
does not appear when the actual error occurs. The error occurs 
at some point between the message and the last location or sub¬ 
routine reference. 

To correct phase errors, rerun MASM with the /d command 
option. This option generates a listing for both assembly passes. 
(Disregard the errors that MASM finds during the first pass; 
they are normal.) For each instruction above the phase error, 
compare the hex instruction bytes in the pass 2 listing with the 
same instruction bytes in the pass 1 listing. You will find one 
instruction that has a 1 byte difference between the two passes. 
In the example below MASM codes a 4 byte move instruction in 
pass 1, but corrects its error in pass 2, using a 3 byte move 
instruction. Correcting the instruction creates a phase error. 
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Example 7-12: Phase Error Pass 1 Listing 

002A 8B IE 0000 U mov bx,seg_c 

testxxx.ASM(40): error A2009: Symbol not defined:SEG_C 

002E 8E C3 mov es.bx 

0030 E8 0000 U call sub_2 

testxxx.ASM(42): error A2009: Symbol not defined:SUB_2 

0033 testa: 


Example 7-13: Phase Error Pass 2 Listing 


002A 

BB 

-- R 

mov 

bx,seg_c 

002D 

8E 

C3 

mov 

es.bx 

002F 

E8 

0052 R 

call 

sub 2 


testa: 

testxxx.ASM(43): error A2006: Phase error between passes 


In the example, MASM cannot handle a valid 8088 instruction. 
You can use TASM or OPTASM to reassemble the source code. 
You may also be able to correct the problem by changing the 
instructions so MASM will accept them. In the example, you 
could replace the problem instruction (mov bx, seg_c) with the 
following instructions: 

mov ax,seg_c 

xchg ax,bx 

Unlike the original code which does not affect the AX register, 
the replacement instructions assume that it is safe to change the 
AX register. 

You can correct other phase errors in a Sourcer definition file by 
forcing the offending instruction to data mode and forcing the 
next instruction back to code mode. Then rerun Sourcer and 
reassemble the output file. 

Illegal Size for Operand Error 

This error should not occur, because Sourcer locks the data 
types prior to its last pass. If it does occur, perhaps the 
instruction should be data. Also, check that Sourcer used at least 
5 passes to generate the source code. To eliminate this error, edit 
the Sourcer output file so it has the proper PTR override (for 
example, WORD PTR DATA_217 or use a definition file entry to 
change the instruction to data bytes. 
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Changing Generated Source Code 

If you are making small changes to a program, avoid adding or 
removing bytes from the program. To remove code, replace 
each byte of instruction code with a NOP instruction. The 
following examples show code before and after removing an 
instruction. 


Example 7-14: Original Code 


mov 

al,1 

call 

sub_2 

or 

al,4 

Example 7-15: Code after Removing an 

Instruction 

mov 

al,1 

nop 


nop 


nop 


or 

al,4 


The example uses three NOP instructions to remove the CALL 
instruction, because the CALL instruction was three bytes long. 

If you need to add instructions, be extremely careful not to 
change indexed references to data items. If the original code 
used an offset to a data item, your changes may cause the pro¬ 
gram to handle the offset as a number. As long as you make 
changes and additions after indexed data references, you 
should encounter no problems. 

For example, if a program consists of separate data and code 
areas with the data area first, changes you make in the code area 
will not affect indexed data references. You can add new code 
or delete code with little risk. On the other hand, if you modify 
items in the data area, you would make all indirect references to 
data items inaccurate. 
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Patching Programs 

Once you've determined the location to change, you can patch a 
program instead of reassembling it. Patching a small program 
can be quicker than reassembling it. Patching is also useful for 
programs too large for your assembler. 

To patch a COM-type program, use the DOS DEBUG program 
to change the appropriate bytes and write the new file. 

To patch an EXE-type program, you must insure that you 
change bytes at the correct point without changing the EXE file 
header. 

1. First, copy the program file to a file that has the same file¬ 
name and the extension .TMP. 

2. Load the new file into DEBUG. At the DEBUG prompt, 
enter: 

-d 108 

3. The word at offset 108h is the size of the header in para¬ 
graphs. Remember to convert the two bytes DEBUG shows 
to a word. For example, if the value DEBUG shows 00 01, 
use the word OlOOh. Add a 0 nibble to convert to bytes. If the 
value is 0020, the header is 200h bytes long. 

4. Add the header size in bytes plus lOOh to determine point in 
memory where the program begins. 

5. Determine the location of the bytes to change by adding the 
value computed in step 4 to the actual location you want to 
change in the first segment. 

If you want to change an item in a later segment, also add 
the difference between the first segment and the item's seg¬ 
ment. The .SDF file shows the values associated with each 
segment name. 

Before you make changes, check the bytes you are changing 
against a listing to make sure that you calculated the correct 
location. 

6. Make the necessary changes. 

7. Write the file back to disk. 

8. Change the file extension back to .EXE. 
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The following example shows how to calculate a patch location. 


Example 7-16: Planning for a 1-byte Patch at Offset 45h in seg c 


word offset at 108h in DEBUG = 20h (or 200h header bytes) 


seg_a = 7200h 
seg_c = 7250h 



bytes to 


patch 

header + PSP + seg_c from seg_a 

+ 

offset 

(20h* lOh) + lOOh + ((7250h-7200h)*10h) 

+ 

45h = 845h 


The result, is 845h, is the offset at which to make the change. 
This calculation is based on the DS segment value created by 
DEBUG when it loads the file. You can view the bytes with the 
D command, or alter bytes with the E command. 

The U (unassemble) command, uses the CS segment register, 
not the DS register. To unassemble at this location, view the 
present DS register with the R command, and set the CS register 
to the same value using the RCS command. For more 
information about using DEBUG, see the DOS documentation. 


Sourcer User Manual 79 








Chapter 8: Command Reference 


Main Menu Commands 


General Commands 





Esc 


Help 

Displays command summaries in 
the Help screen. 

Go 

Starts processing the input file or 
address range. Operates after you 
enter a valid file or address range. 

Quit 

Quits Sourcer; available at all times 
while Sourcer is running. 

Quit 

Quits Sourcer; available at all times 
while Sourcer is running. 


Output Formatting Commands 


File format Selects output file format: either 
listing or source code. 

Header title Lets you enter a title (up to 32 

characters long) to display on each 
page of a listing file. A default title 
appears after you load an input file. 


F 


H 
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L 

Label type 

Selects a label type and shows an 
example of its format. 



0 

Output 

filename 

Sets the output filename. The default 
is the input filename or temp (when 
there is no input file). 



R 

Remarks 

Selects automatic comment types. 




S 

Segment 
on/off 

Turns segment display on or 
off in the listing file. 


T 

Tabs on/off 

Selects either tabs or spaces for use 
in the output file. Tabs reduce the 
required file space by half. 



W 

Word case 

Specifies either uppercase or 
lowercase instructions and labels in 



the output file. 

X 

Xref on/off 

Turns automatic cross-referencing 
on or off. 


Processing Commands 






Analysis 

Options 

Displays Analysis Options Menu. 
(For a detailed description of each 
option, see page 17. For a summary 
of each option, see page 83.) 

Beginning 

address 

Lets you enter the address at which 
to begin processing. 

Code style 

Sets the code style. 

Drive 

Lets you specify the disk drive to use 
for output. 

Ending 

address 

Lets you enter the ending address of 
the first segment at which to stop 
processing. 
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Input 

filename 

Lets you name an input file for 
processing. 

Math 

Turns the math co-processor filter on 
or off. 

Passes 

Sets the number of passes from 

2 to 9. 

micro¬ 

processor 

Sets the microprocessor filter. 


Analysis Options 


Press A from the Main Menu to display the Analysis Options 
Menu. You turn options on and off by pressing the 
corresponding keyboard key. When the option letter appears in 
uppercase, the option is on. When the letter appears in 
lowercase, the option is off. This section gives the effects of 
turning on an option. For a complete description of each option, 
see page 17. 



Instructs Sourcer to remain in code mode after a 
jump instruction instead of switching to data mode. 

Instructs Sourcer to remain in code mode after a 
return instruction instead of switching to data mode. 

Instructs Sourcer to remain in code mode after an 
interrupt return instead of switching to data mode. 

Sets the DS and ES defaults to the code segment. 


Instructs the code simulator to ignore changes to the 
DS and ES simulation registers. 

Prevents Sourcer from detecting terminated 
subroutines. 

Forces indexed data references Oh to lOOh to equates. 
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Forces indexed data references Oh to 200h to equates. 


Prevents Sourcer from using graphics characters in 
the output file. 

Prevents Sourcer from detecting interrupt vector 
entry points into the program. 

Prevents Sourcer from writing absolute location 
reference comments for jumps and calls. 

Prevents Sourcer from using the instruction 
mnemonics RETF/RETN for return far and near. 
Turn on this option if you are planning to reassemble 
generated code with MASM version 4.0 or earlier. 

Prevents Sourcer from fixing references that appear 
as 16-bit displacements in the binary file. Turn on 
this option if you are planning to reassemble 
generated code with MASM version 4.0 or earlier. 

Prevents Sourcer from placing necessary ASSUME 
statements in code. 

Turn on this option to use the index register (BX, BP, 
SI, or DI) as is for indexed jumps and calls. When 
option P is turned off, Sourcer ignores the index reg¬ 
ister value when it is less than 180h. 

Instructs Sourcer to cross-reference all data 
references. 

Instructs Sourcer to cross-reference all location 
references. 

Instructs Sourcer to cross-reference all subroutine 
references. 

Prevents Sourcer from cross-referencing locations 
less that 128 bytes away from each other. 

Prevents Sourcer from interpreting indexed data 
values -64h through +64h as offsets. 
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Prevents Sourcer from fixing near jumps. 

Prevents Sourcer from adding warning remarks. 

Allows Sourcer to create references during the final 
pass. 
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This chapter suggests actions you should take to correct 
problems you encounter while running Sourcer. If you 
encounter a problem when reassembling generated code, see 
Chapter 7, "Reassembling Generated Source Code." 


General Problems 

This section describes problems that occur without Sourcer 
warning messages. 


Cannot Access Sourcer 

Check whether the file SR.EXE is in the current directory or on 
the current diskette. 


System Locks Up While Processing A File 
Check the microprocessor filter. The V20/30 filter can cause 
some 8086-based systems to halt. (See page 15.) Also, try 
removing other memory-resident programs. 


Screen is Difficult to Read or the Color Changes 

If you are using a CGA card with a composite monochrome 

monitor enter the following command at the DOS prompt: 

mode bw80 

If you are using a EGA or VGA adapter that is not fully IBM- 
compatible, start Sourcer with the -v command line option. (See 
page 30.) 

If your system does not support one of the IBM display 
standards, start Sourcer with the -n command line option. (See 
page 30.) 
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Listing Is Difficult to Read 

A listing file (.LST) is 132 columns wide, so you must view it 
with an editor or listing program that lets you view all 132 
columns or scroll left and right. For a list of recommended 
programs, see Appendix D, "Other Useful Programs." For 
instructions on changing the format of the listing, see page 31. A 
source code (.ASM) file usually fits in 80 columns. 


"Reassembly Not Recommended" Appears in Output File 
The definition file used the multi-defined option. Code gen¬ 
erated with this option will not reassemble correctly. To 
reassemble the file, remove multi-defined labels from the 
definition file and generate a new assembly file. 


Sourcer Messages 

This section lists each Sourcer message (in numerical order) and 
give suggestions for correcting problems. 


Message 1: File does not have a binary extension type. 

The input file must be a binary file with one of the following 
filename extensions: .COM, .DRV, .EXE, .SYS, .BIN, .OVR, 
.OVL, or .OV1 to .OV4. If the file is a binary file, but has a 
different extension, rename it so that it has a valid extension. 


Message 2: WARNING: Output file already exists. Overwrite 
(Yes/No) ? 

The specified output file already exists. Press Y to overwrite it, 
or press N to enter a new filename. 


Message 3: WARNING: Packed file, conversion quality low. 
The input file is packed, making jump references inaccurate, 
data areas compressed, and multiple segments unresolvable. 
Output results will generally be inaccurate. 

DOS does not perform file unpacking. However, the packer 
program attaches an unpacking routine to the end of the packed 
file. There are a number of packer programs and there is no 
standard packing technique. Sourcer generates a START: label 
at the beginning of the unpack routine. However, when 
multiple-segment EXE programs are packed, all of the 
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relocation information is moved from the header to the 
unpacker routine which makes it impossible for Sourcer to 
determine how segments are separated. 

If possible, use the unpacked version of the input file or convert 
the packed file to an unpacked EXE file. UNPACKER, available 
from V Communications, can convert most packed files into 
their original unpacked format. 


Message 4: WARNING: Cross-reference table full, not all 
xrefs identified. 

The cross reference table is full; references made later in the 
program are not included. To avoid filling the cross-reference 
table, use analysis options Q through T to select only a subset of 
all cross-references. For more information, see page 27. 

If your system has 640 Kb of memory and has no RAM-resident 
programs and if the file to analyze is over 220 Kb, Sourcer 
reduces the size of the reserved cross-reference table to fit the 
file the available memory. 


Message 5: WARNING: Keep function ignored and set to 
both. 

The Keep option must occur before the Input filename option in 
a definition file. Sourcer ignores the Keep option specified in the 
definition file and sets its value to BOTH. BOTH is the 
appropriate value for most input files. (See page 38.) 


Message 6: WARNING: Hidden EXE file, output quality low. 
This message appears when a file with the extension .COM is 
really a multi-segment EXE file. Such files contain an EXE 
converter (at the end). DOS loads the file as a COM file. 
However, when the program starts, the EXE converter actually 
starts first to support the relocation information of the original 
EXE program. Use the EXE version or convert to EXE before 
using Sourcer. COM2EXE, included in the UNPACKER set of 
utilities, can convert these multi-segment COM files to EXE 
files. 

Only a few IBM/Microsoft supplied programs use this multi¬ 
segment COM format. In DOS 3.30 the following programs are 
multi-segment COM files: CHKDSK, DEBUG, EDLIN, FDISK, 
FORMAT, GRAFTABL, GRAPHICS, PRINT, RECOVER, and 
SYS. 
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Message 10: Symbol table full. 

Sourcer reserves 192 Kb for symbol space and uses variable- 
length records for maximum compression. To allow more 
entries in the tables, you can 

■ Set the Label type to seg_offset or ltrseg_off (Press L from 
the Main Menu). 

■ Move comments in section three of the definition file into a 
remarks file. (See Chapter 6, "Adding Comments to the 
Output File.") 

■ Eliminate entries in section three of the definition file. 

■ If possible, use a smaller file or address range. 

■ Add the following line to your definition file: 

Just skip relocations = 1 

This line instructs Sourcer to skip loading EXE relocation 
entries to save symbol space in the location table. It must 
appear in the definition file before the Input filename option. 
A Sourcer-generated definition file (SDF file) never includes 
this option. 


Message 11: Disk full. 

Clear sufficient disk space for the output file or select an option 
that uses less space (for example, output tabs instead of spaces). 
The output file is correct up to the point where the disk became 
full. You can also send output directly to a printer. For 
instructions, see page 32. 


Message 12: Output file disk operation failed. 

An error occurred while Sourcer was writing the output file. 
Check that the disk is operating properly. If you directed the 
Sourcer output to a diskette, you must not remove the diskette 
while Sourcer is running. 


Message 13: Sourcer CANCELLED - No files created or 
processed 

Appears when you press the Q or Esc key to quit Sourcer. 
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Message 14: Sourcer CANCELLED - Partial file processed. 
See message 13. Sourcer may have created part of the output 
file. 


Message 15: File not found or path is invalid. 
Retry using a valid filename and/or path. 


Message 16: File access denied. 

The specified file is not accessible. Retry with an accessible file. 


Message 17: Insufficient memory to load the file. 

To provide additional memory, you can: 

■ Remove any RAM-resident programs. 

■ Add main memory if your system has less than 640 Kb. 

■ Reduce the input program size (usually difficult to do). 

■ Set the CONFIG.SYS file statements FILES and BUFFERS to 
lower numbers. 

■ Switch to an earlier version of DOS (saves up to 50 Kb). 

Only EXE type files can extend beyond the 64 Kb segment 
boundary. Files with other extensions generate this error 
message if the file size is greater than 65,534 bytes. 

Sourcer uses DOS to load the file. In some cases it may be 
possible to add 64 Kb of additional memory from AOOOh to 
AFFFh if unused by the video adapter (CGA, MDA or 
Hercules). To address this area, you usually need a special 
memory card. 

Some files store data in overlays at the end of the executable 
code. In such cases, amount of memory required to load the file 
may be less than the total file size reported by DOS. 

In some cases, you can reduce the size of an EXE file to fit into 
memory. Copy the file and use DEBUG to reduce the size of the 
duplicate. The following example shows how to change a 
375 Kb EXE file (MYFILE.EXE) to a 200 Kb EXE file 
(NEWFILE.EXE). This method works very well if the end of the 
EXE file is simply buffer space used by the program but not 
directly referenced. In some cases, however, the resulting 
program can be unclear. 
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Example 9-1: Reducing File Size 

Original file size: 375,776 bytes = 5BBE0h = 2DEh * 200h + lEOh (EXE header format) 

Planned file size: 200,000 bytes = 30D40h = 186h * 200h + 13Fh (EXE header format) 

1. Copy the EXE fiie (MYFILE.EXE) to a new file (NEWFLE.TMP). 

COPY MYFILE.EXE NEWFILE.TMP 

2. Start DEBUG with the new file loaded. 

DEBUG NEWFILE.TMP 

3. Use the -r command to display the registers. 

AX=0000 BX=0005 CX=BBE0 DX=0000SP=E12BBP=0100 Sl=0000 Dl=0000 

DS=1DC4 ES=1DC4 SS=1DC4 CS=1DC4 IP=0100NV UP El PL NZ NA P0 NC 

1DC4:0100 4D DEC BP 

4. The BX register contains the upper 16 bits of the file size. Change it to 3 (for a new size of 30D40h). 

-rbx 

BX 0005 
:3 

5. The CX register contains the lower 16 bits of the file size. Change it to D40h. 

-rex 

CX BBE0 
:d40 

6. Display the EXE file header. 

-d 100 L6 

1DC4:0100 4D 5A E0 01 DE 02 

The word at offset 102h (OlEOh) is the file size remainder. The word at offset 104h (02DEh) is 
the file size divided by 200h. 

7. Change the remainder to 13Fh. 

-e 102 

1DC4:0102 0F.3F 01.1 

8. Change the file size divided by 200h to 786h. 

-e 104 

1DC4:0104 DE.86 02.1 

9. Write the file to disk. 

-w 

Writing 30D40 bytes 

10. Quit DEBUG. 

-q 

11. Rename the new file so it has a .EXE extension. 

RENAME NEWFILE.TMP NEWFILE.EXE 
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This method works only to shorten files (you must keep the first 
part and discard the last part), because the relocation 
information is not easily adjustable. 


Message 18: Unable to load file. 
Retry with a valid file. 


Message 19: Cannot open output file. 

Output file may already exist and is set to read only. 

Message 20: Not a valid EXE file header. 

The EXE file header is corrupt and cannot be processed. View 
the EXE header with the DOS EXEMOD utility. 

Message 21: Table error, contact customer service 
Sourcer detected an internal program error. Contact 
V Communications Customer Service. 


Message 22: Internal fatal error 

Sourcer detected an internal program error. Contact 

V Communications Customer Service. 


Message 23: Bad opcode processed: xxh at segment:offset. Press 
any key. 

Sourcer encountered an internal error. Note the opcode and 
contact V Communications Customer Service. 


Message 24: Invalid begin segment value in def file at line 
number 

The value of the Begin segment control option must be greater 
than or equal to the value of the location at which Sourcer 
would normally load the file. The number you entered is either 
too small or not a valid hex number. (See page 37.) 


Message 31: Incorrect entry in definition file at line number 
XXXX 

The loaded definition file has an error, such as a non-hex digit 
in a number or an incorrectly formatted line. Check the defini¬ 
tion file. 
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Message 32: Definition file disk operation failed. 

Sourcer could not read the definition file. Check that the defini¬ 
tion file is valid. 


Message 33: Cannot open definition file. 

Sourcer could not open the specified definition file. Check 
whether the file exists in the specified subdirectory (or the de¬ 
fault subdirectory). 


Message 34: WARNING Could not find or load .rem file. 

The remarks file associated with the definition file of the same 
filename could not be found. The remarks file should be in the 
same subdirectory or disk as the definition file. If not supplied, 
Sourcer can proceed without it, but special remarks and com¬ 
ments will not appear in the output. 


Message 35: Cannot open the remark file. 

Sourcer found the remarks file, but could not open it. Check 
whether the remarks file is in the same directory or on the same 
diskette as the specified definitions file. 


Message 36: Incorrect entry in remark file at line number 
XXXX. 

The entry on the specified line does not follow the standard 
format and cannot be processed. Entries must begin with a hex 
number, there must be no tabs in entries, and each section must 
have an END statement. 


Message 37: Too many remarks in remark file. Stopped at line 
number XXXX. 

See Chapter 6, "Adding Comments to the Output File," for the 
maximum number of comments allowed in each remarks file 
section. 


Message 39: Too many data entries created in definition file. 
Reduce the number of data entries, reduce the number of times 
a structure repeats, and/or move any comments from within 
the definition file into a remarks file. 
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How Sourcer Works 

When you press G to begin processing a file, Sourcer loads the 
input file into memory and determines the appropriate segment 
ranges. During the first pass, it identifies most of the location, 
data, and subroutine references. Sourcer assumes that both data 
and code areas are code until proven otherwise and determines 
whether duplicate bytes should be considered data. 

Sourcer sorts symbol tables before the start of each successive 
pass and removes invalid references flagged during the previ¬ 
ous pass. Each subsequent pass analyzes the code and data ref¬ 
erences to resolve the data and code areas. The final pass de¬ 
termines necessary assembler directives, formats each line, and 
determines appropriate comments. 

The internal code simulator keeps track of all registers and 
maintains a separate stack for the program. The simulator in¬ 
sures that proper data segments are specified when more than 
one is in use. The simulator also keeps track of detailed com¬ 
ments, identifies I/O ports, and resolves indexed calls and 
jumps. 

Simulation proceeds linearly through the code. The simulator 
ignores jumps and skips instructions that attempt to write into 
memory. However, it processes instructions that read from 
memory. Special handling of the CS register insures full support 
for simulation of ROM and RAM memory locations. 

When it encounters a subroutine call, Sourcer makes a snapshot 
of the simulator registers and saves it with the subroutine. 

When it returns to that subroutine, Sourcer restores the saved 
registers as if the subroutine were called with the proper regis- 
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ter values. Sourcer uses a similar process to save the values in 
the ES and DS segment registers when a subroutine exits. 


Files on the Sourcer Distribution Disk 


File name Description 


README.BAT Batch file that starts up the Sourcer infor¬ 
mation program. The information program 
installs Sourcer, explains Sourcer basics, 
and gives corrections and additions to the 
information in this manual. 


SR.EXE 

SDEFAULT.DEF 

TESTYN.EXE 

TESTYN.DEF 

TESTYN.REM 


Sourcer program file. 

Definition file that sets system defaults. 
Sample program file. 

Definition file for the sample program 
TESTYN; adds descriptive labels and links 
remarks in the file TESTYN.REM. 

Remarks file for the sample program 
TESTYN. 


SAMPLE1 .DEF Blank definition file with detailed com¬ 
ments on commands and file format; use a 
copy of this file to create your own defini¬ 
tion file. 

SAMPLE2.DEF Blank definition file without the 

instructional comments in SAMPLE1.DEF 

INFOSR.COM Sourcer information program. Use 

README.BAT to run. 


Hardware Requirements 

Sourcer is compatible with the IBM PC, XT, AT, and PS/2 com¬ 
puters, all systems that are 100% IBM compatible, and many 
not-so-compatible systems that run PC-DOS or MS-DOS. This 
section provides specific hardware requirements. 
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RAM 

To run Sourcer, your system must have at least 448 Kb of RAM. 
You need additional memory to load a file for processing. For 
example, a 40 Kb file requires an additional 40 Kb of memory. 


Display 

Sourcer supports all standard displays, including MDA, CGA, 
EGA, VGA, and Hercules (in MDA mode). If your display does 
not support one of these standard, start Sourcer with the -n op¬ 
tion to use DOS for all video functions: 

sr -n 

If you are using a monochrome composite monitor with a CGA 
card, run the DOS mode program at the DOS prompt to set 
monochrome operation: 

mode bw80 


Disk Drives 

You do not need a hard disk to process smaller files. If you have 
limited disk storage (for example, no hard disk) be sure to use 
tabs in the Sourcer output file instead of spaces. (A file using 
spaces can be double the size of one using tabs.). When a disk 
becomes full, Sourcer stops processing, closes the file, and 
informs you that the disk is full. You can also send output 
directly to a printer. For instructions, see page 32. 


Sourcer Specifications 

Sourcer Memory: 

Under 400 Kb (does not include DOS). 


Computers Supported: 

IBM PC, XT, AT, and PS/2; IBM-compatible systems; and most 
systems that can run PC-DOS or MS-DOS versions 2.0 
through 4. 


Instruction Sets: 

8088/8086, 8087, V20/V30, 80186/80188, 80286, 80287, 80386, 
80387, and 80486. Supports the 80286, 80386, and 80486 in real 
and protected modes. 
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Input File Types: 

Binary files, COM and BIN type files, multi-segment files, EXE 
type files (up to 250 segments, unpacked), device drivers, pro¬ 
gram overlays, system files, SYS type files, any RAM or ROM 
address within the first 1 Mb of memory, multiple segments. 


Input File Size: 

Up to 260 Kb (on a system with 640 Kb RAM, no RAM-resident 
programs, and DOS 3.0). 


Output: 

Listing or source code file and generated definition file. 

Symbol Tables: 

Separate, RAM-based symbol tables for data, locations, subrou¬ 
tines, and segments. 

Symbol Table Space: 

192 Kb reserved within Sourcer. 


On-line Help: 
One screen. 


Error Handling: 

Errors identified by number and description. Manual contains 
suggested actions for each message. 


Other Notes: 

Single user license with no copy protection. 


Feature Summary 

Inputs 

■ Disassembles binary, EXE, COM, SYS, BIN, device driver, 
overlay, and multi-segment files. 

■ Handles up to 250 segments. 

■ Resolves most segment overlap packing from C compilers. 
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m Disassembles any RAM or ROM address in first 1 Mb of 
memory. 

Output 

■ Source code or listing. 

■ Uppercase or lowercase. 

■ Selectable comments. 

■ Selectable label styles. 

■ Output sent to disk or printer. 

Code Support 

■ Selectable instruction sets: 8088, 80186, 80286, 80386, 80486, 

& V20/V30. 

■ Math co-processor instruction set support: 8087, 80287, and 
80387. 

■ Unique labels for location references, data references, sub¬ 
routine references, segments, equates, procedures, loops, 
interrupt entries, and other items. 

Assembler Directives 

■ Inserts assembler directives as required for reassembly. 

■ Supports SEGMENT, ENDS, PROC, ENDP, END, ASSUME, 
PAGE, ORG, EQU, Processor type, PTR overrides, and other 
directives. 

■ Determines data types, bytes, words, double words, text 
strings, duplicate bytes and resolves overlaps. 

Comments 

■ All infrequently used and complicated instructions. 

■ Interrupts including BIOS calls, DOS calls, EMS 4.0, and 
most common adapter cards for PC and PS/2 machines. 

■ Input and output port numbers and functions. 

■ Segment, offset, and value for referenced data item. 

■ Program flow. 
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Special Features 

■ Output appears in the same style as original assembly 
source code. 

■ Internal program simulation resolves data items across seg¬ 
ment boundaries. 

■ Automatically analyzes indexed jump and call instructions. 

■ Definition file facility allows adding comments and descrip¬ 
tive labels, setting defaults, specifying segments, and fine 
tuning results. 

■ Finds and identifies TSR entry points. 

■ Cross-references. 

■ Uses correct mnemonic for multiple-mnemonic instructions. 

■ Automatically detects device drivers and finds entry points. 

■ Automatically corrects for assembler limitations. 

■ Displays progress on screen. 

■ Provides descriptive labels for commonly referenced BIOS 
data items. 


Compatibility with Earlier Versions 

If you have been using an earlier version of Sourcer, there are 
several changes you should note. 

Version 1.72 and Earlier 

If you have been using version 1.72 of Sourcer, you may need to 
modify your definition files. This section describes changes that 
affect definition files. 


Control Information: Section One 

Analysis options M and N have different functions. In definition 
files, use the Math on control option instead of the M option. 

(See page 39.) The earlier function of the N option is no longer 
needed, because Sourcer automatically uses a remarks file 
whenever remarks file comments are specified in the definition 
file. 

The functions of analysis options K and L are now the opposite 
of their functions in earlier versions of Sourcer. By default. 
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option K is off and the Sourcer listing contains comments for 
jumps and calls. Turn on option K to prevent Sourcer from 
listing these comments. (See page 23.) Option L is also off by 
default, and Sourcer uses the RETF (return far) and RETN 
(return near) instructions. Turn on this option to prevent 
Sourcer from using these instructions if you are using MASM 
4.0 or an earlier assembler that does not support them. (See 
page 23.) 


Note: If the code you are disassembling was originally 
processed by an optimizing compiler or assembler (such as 
MASM 5.0 or later) and you set Sourcer analysis options for 
compatibility with MASM 4.0, Sourcer cannot generate code 
that is identical to the original. If you normally use MASM 4.0 
to reassemble generated code, you might consider upgrading 
to MASM 5.0 or later. 

The Keep statements statement is no longer necessary. By 
default, Sourcer compares segment table entries loaded from 
the input file with range definitions in section two of the 
definition file. If there are any differences, it uses the definition 
file entries. (See page 38.) 

The Lower case off option has been changed to Word upper. 
(See page 42.) 

The Remarks option has seven options for turning on and off 
automatic comments. (See page 40.) 


Range Definitions: Section Two 

Sourcer now supports up to 250 segment variable names. 
Output files use full variable names instead of abbreviations. 
For more information, see page 43. 


Reference Definitions: Section Three 

You can now specify comments to be included in output files as 
part of a reference definition entry. Comments must appear in 
the last column of the entry. A comment preceded with a 
semicolon (;) appears only in the definition file. Otherwise, 
comments appear in output files. If there are comments for an 
item in both the reference definition and the remarks file, 
Sourcer uses the comment in the reference definition. For more 
information, see Chapter 6, "Adding Comments to the Output 
File." 
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The EXT (external) location option has changed. It resets the 
simulator and produces an external entry comment. However, it 
no longer generates a far procedure. Use EXT for external entry 
points only. To generate a far procedure, use the FAR option. 

For more information, see page 49. 

Version 1.9 and Earlier 

If you have been using version 1.9 or an earlier version of 
Sourcer, you should note the following changes: 

■ Sourcer now supports the 80386 and 80486 instruction sets 
and the 80387 math instruction set. (See page 15.) 

■ Each time you process a file, Sourcer automatically generates 
a definition file containing command and option settings, 
segment range definitions, and all locations, subroutines, 
and other items it identified. This file has the output 
filename and the extension .SDF. Use it as a reference when 
you read a listing, or use it as the basis of your own 
definition file. (See page 35.) 

■ There are several new definition file features: 

- You can specify 16- or 32-bit segment ranges. (See 
page 45.) 

- The DA (ASCII data) item type can automatically 
determine text string length. (See page 47.) 

- Labels are optional. 

- Definition files can use full segment variable names. (See 
page 43.) The following table compares full variable 
names with the old-style abbreviations. The abbrevia¬ 
tions are still supported. 

Segment Variable Names Abbreviation 

seg_a to seg_z sega to segz 

seg_aa to seg_az sgaa to sgaz 

seg_ba to seg_bz sgba to sgbz 


seg_ia to seg_iz 


sgia to sgiz 
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- You can specify a memory location at which to load the 
input file. (See page 37.) 

- Fixed field formats are eliminated. 

■ Sourcer now analyzes code in two to nine passes. (See 
page 15.) 

■ Sourcer now supports displays that are not IBM compatible. 
(See page 30.) 

■ You can set Sourcer command line options in the DOS 
environment. (See page 30.) 

■ Sourcer is Desqview compatible. 
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Customer Support 

If you have a problem with Sourcer, gather the following 
information before contacting V Communications Customer 
Service: 

■ Program version, and serial number. Both appear on the 
diskette label and in the upper right corner of the screen 
when you are running Sourcer. 

■ Computer name and model number. 

■ Printed listing (if the problem is in an output file). 

You can contact V Communications Customer Service at: 

V Communications, Inc. 

3031 Tisch Way, Suite 802 
San Jose, C A 95128 
(408) 296-4224 


Product Update Policy 

Registered Sourcer users can purchase a software update for 
major new releases for a nominal fee. The update includes a 
new program diskette and manual. Contact V Communications 
Customer Service for update information and fees. 
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The 80386 and 80486 instruction sets have both 16- and 32-bit 
forms of many instructions. In addition, the segment size 
attribute of a code segment can be 16 bits (in real or protected 
mode) or 32 bits (in protected mode only). When you use 
protected mode, Sourcer must be able to determine the segment 
size attribute in order to correctly disassemble a file. For 
example, the following instruction is coded differently 
depending on the mode of operation: 

mov ax, 1234h 

When the segment size attribute is 16 bits, the instruction moves 
the value 1234h to the AX register. However, when the segment 
size attribute is 32 bits, the instruction moves the value 
jcccel234h to the EAX register, where xxxx is the 16-bits 
following 1234h. In both cases, the opcodes are the same. To 
properly disassemble the coded instruction, Sourcer must know 
the segment size attribute. 

There are three ways Sourcer can determine the segment size 
attribute: 

■ In some cases, Sourcer can automatically determine the 
segment size attribute. The BIOS interrupt 15h, service 89h is 
the most common method of switching between 16- and 32- 
bit modes. In most cases, Sourcer can use this interrupt to 
determine the segment size attribute. 

■ You can specify 16- and 32-bit segment ranges in the range 
definition section of a definition file. (See page 45.) 

■ You can use the CODE16 and CODE32 forced function 
options in the reference definition section of a definition file 
to force Sourcer to switch between 16- and 32-bit modes. 

(See page 50.) 
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The 80386 and 80486 instruction sets are very complex, and you 
may require additional information to determine when a 
program switches modes. It can take experienced assembly- 
language programmers months of full-time work to fully 
understand the subtle complexities of these microprocessor 
instruction sets. For sources of information about these 
microprocessors, see Appendix E, "Reference Materials." 
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Programs 


This appendix contains a list of other programs you might find 
helpful while using Sourcer. You may find other programs, not 
listed here, to be helpful as well. 


File Viewers and Editors 

The following table contains a list of file viewers and editors 


that support 132-column (or longer) lines. 
Program Publisher 

Notes 

InView 

V Communications 

3031 Tisch Way, Suite 802 
San Jose, CA 95128 
800-662-8266 

File viewer. 

Very fast. Capable 
of displaying full 
132 columns. 

Brief 

Solution Systems 

541 Main St., Suite 541 

S. Weymouth, MA 02190 
(617) 337-6963 

Editor. Displays 80 
columns. Allows 
left and right 
scrolling. 

Multi-Edit 

American Cybernetics, Inc. 
1228 N. Stadem Dr. 

Tempe, AZ 85281 
(602) 968-1945 inside AZ 
800-221-9280 outside AZ 

Editor. Displays 80 
columns. Allows 
left and right 
scrolling 

PC-Write 

Quicksoft 

219 First N. #224 

Seattle, WA 98109 
(206) 282-0452 

Editor. Shareware. 
Displays 80 
columns. Allows 
left and right 
scrolling. 
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Assemblers 


Program 

Publisher 

Notes 

Macro 

Assembler/2 

IBM Corporation 

Contact IBM 

Authorized Dealer 

Not tested 

MASM 5.1 

Microsoft 

16011 Northeast 36th Way 
Redmond, WA 98073 
800-426-9400 

Good 

documentation 

OPTASM 

SLR Systems 

1622 N. Main St. 

Butler, PA 16001 
800-833-3061 

Very fast, 
no phase 
errors 

TASM 

Borland 

1800 Green Hills Rd. 

Scotts Valley, CA 95066 
800-331-0877 

Very fast, 
no phase 
errors 

Other Useful Products 


Program 

Publisher 

Notes 

ASMtool 

V Communications 

3031 Tisch Way, Suite 802 
San Jose, C A 95128 
800-662-8266 

Assembly 

program 

analyzer 

and 

flowcharter 

UNPACKER 

V Communications 

3031 Tisch Way, Suite 802 
San Jose, CA 95128 
800-662-8266 

Assembly 

programming 

utilities 

(UNPACK, etc.) 
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Assembly Language 

Jourdain, Robert. Programmer’s Problem Solver for the IBM PC, XT 
& AT. New York: Prentice Hall Press, 1986. 

Lafore, Robert. Assembly Language Primer For the IBM PC & XT. 
New York: New American Library, 1984. 

Miller, Alan R. Assembly Language Techniques for the IBM PC. 
Berkeley, CA: Sybex Inc., 1986. 


BIOS 

Personal System/2 and Personal Computer BIOS Interface Technical 
Reference. IBM Corporation, 1988. To order contact IBM 
Corporation, PO Box 2009, Racine, WI53404; 
800-465-1234. (Order number 68X2341). 


DOS and Assembly-language Programming 

Angermeyer, John and Kevin Jaeger. MS-DOS Developer's Guide. 
Indianapolis, IN: Howard W. Sams & Co. 1986. 

Duncan, Ray. Advanced MS-DOS Programming. Redmond, WA: 
Microsoft Press, 1988. 

Duncan, Ray. MS-DOS Encyclopedia. Redmond, WA: Microsoft 
Press, 1988. 
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Instruction Sets and Microprocessors 

iAPX 86/88,186/188 User’s Manual Intel Corporation, 1986. To 
order contact Intel Corporation, PO Box 58130, Santa 
Clara, CA 95052; 800- 548-4725. (Order number 
210911-003). 

80286 and 80287 Programmer's Reference Manual. Intel 

Corporation, 1987. To order contact Intel Corporation, 
PO Box 58130, Santa Clara, CA 95052; 800-548-4725. 
(order number 210498-004) 

80386 Programmer's Reference Manual. Intel Corporation, 1986. 

To order contact Intel Corporation, PO Box 58130, Santa 
Clara, CA 95052; 800-548-4725. (order number 230985- 
001 ) 

Intel i486 Microprocessor. Intel Corporation, 1989. To order 

contact Intel Corporation, PO Box 58130, Santa Clara, CA 
95052; 800-548-4725. (order number 240440-001) 


Video Systems 

Wilton, Richard. Programmer's Guide to PC & PS/2 Video Systems. 
Redmond, WA: Microsoft Press, 1987. 
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This appendix contains opcode decoder and character set tables. 
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Opcode Decoder Table 

LOW 


HI 

0 

1 

2 

3 

4 

5 

6 

7 

0 

add 

add 

add 

add 

add 

add 

push 

pop 


mb=mb+rb 

mw=mw+rw 

rb=rb+rmb 

rw=rw+rmw 

al=al+ib 

ax=ax+lw 

es 

es 

1 

adc 

adc 

adc 

adc 

adc 

adc 

push 

pop 


mb=mb+rb 

mw=mw+rw 

rb=rb+rmb 

rw=rw+rmw 

al=al+ib 

ax=ax+iw 

ss 

ss 

2 

and 

and 

and 

and 

and 

and 

es: 

daa 


mb=mb,rb 

mw=mw,rw 

rb=rb,rmb 

rw=rw,rmw 

al=al,ib 

ax=ax,iw 



3 

xor 

xor 

xor 

xor 

xor 

xor 

ss: 

aaa 


mb=mb,rb 

mw=mw,rw 

rb=rb,rmb 

rw=rw,rmw 

al=al,ib 

ax=ax,iw 



4 

inc 

inc 

inc 

inc 

inc 

inc 

inc 

inc 


ax 

cx 

dx 

bx 

sp 

bp 

si 

di 

5 

push 

push 

push 

push 

push 

push 

push 

push 


ax 

cx 

dx 

bx 

sp 

bp 

si 

di 

6 

pusha 1 

popa 1 

bound 1 

arpl 2 

fs: -~ 3 

gs: ~* 3 

Operand 

Address 




rw md 


repne -- v 

repc -- v 

Size 

Size 

7 

jo 

jno 

jb 

jae 

je/jz 

jne/jnz 

jbe 

ja 

8 

Tables 

Table S 

Tables 

Table S 

test 

test 

xchg 

xchg 


rmb=rmb,ib 

rmw=rmw,iw 

rmb=rmb,ib 

rmw=rmw,ib 

flg=rb,rmb 

flg=rw,rmw 

rmb,rmb 

rmw.rmw 

9 

nop 

xchg 

xchg 

xchg 

xchg 

xchg 

xchg 

xchg 



cx,ax 

dx.ax 

bx,ax 

sp,ax 

bp,ax 

si,ax 

di,ax 

A 

mov 

mov 

mov 

mov 

movsb 

movsw 

empsb 

empsw 


al=mb 

ax=mw 

mb=al 

mw=ax 





B 

mov 

mov 

mov 

mov 

mov 

mov 

mov 

mov 


al=ib 

cl=ib 

dMb 

bl=ib 

ah=ib 

ch=ib 

dh=ib 

bh=ib 

C 

Table V 

Table V 

retn 

retn 

les 

Ids 

mov 

mov 


rmb.ib 

rmw.ib 

sp=sp+iw 




rmb=ib 

rmw=iw 

D 

Table T 

Table T 

Table T 

Table T 

aam 

aad 


xlat 


rmb,1 

rmw,1 

rmb,cl 

rmw.cl 





E 

loopnz 

loopz 

loop 

jcxz 

in 

in 

out 

out 






al.ib 

ax.ib 

ib.al 

ib.ax 

F 

lock 


repnz / 

rep / repe 

hit 

cmc 

Table U 

Table U 


repne 


/ repz 




rmb 

rmw 


Codes 

mb = memory, byte 
mw = memory, word 
md = memory, doubleword 


mq= memory, quad word 
rb = register, byte 
rw = register, word 


rd = register, double word 
rmb = register or memory, byte 
rmw= register or memory, word 


ib = immediate, byte 
iw= immediate, word 
fig = flags 
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LOW 


HI 

8 

9 

A 

B 

C 

D 

E 

F 

0 

or 

or 

or 

or 

or 

or 

push 

Table W2 


mb=mb,rb 

mw=mw,rw 

rb=rb,rmb 

rw=rw,rmw 

al=al,ib 

ax=ax,iw 

cs 


1 

sbb 

sbb 

sbb 

sbb 

sbb 

sbb 

push 

pop 


mb=mb-rb 

mw=mw-rw 

rb=rb-rmb 

rw=rw-rmw 

al=al-ib 

ax=ax-iw 

ds 

ds 

2 

sub 

sub 

sub 

sub 

sub 

sub 

cs: 

das 


mb=mb-rb 

mw=mw-rw 

rb=rb-rmb 

rw=rw-rmw 

al=al-ib 

ax=ax-iw 



3 

cmp 

cmp 

cmp 

cmp 

cmp 

cmp 

ds: 

aas 


mb=mb,rb 

mw=mw,rw 

rb=rb,rmb 

rw=rw,rmw 

al=al,ib 

ax=ax,iw 



4 

dec 

dec 

dec 

dec 

dec 

dec 

dec 

dec 


ax 

cx 

dx 

bx 

sp 

bp 

si 

di 

5 

pop 

pop 

pop 

pop 

pop 

pop 

pop 

pop 


ax 

cx 

dx 

bx 

sp 

bp 

si 

di 

6 

push 1 

imul 1 

push 1 

imul 1 

insb 1 

insw 1 

outsb 1 

outsw 1 


iw 

rw=rmw*iw 

ib 

rw=rmw*ib 





7 

js 

jns 

jP 

jnp 

jl 

jge 

jle 

jg 

8 

mov 

mov 

mov 

mov 

mov 

lea 

mov 

pop 


rmb=rb 

rmw=rw 

rb=mb 

rw=mw 

rmw=rseg 

flg=rw,rmw 

rseg=rmw 

mw 

9 

cbw 

cwd 

call far 

wait 

pushf 

popf 

sahf 

lahf 








flg=ah 

ah=flg 

A 

test 

test 

stosb 

stosw 

lodsb 

lodsw 

scasb 

scasw 


flg=al,ib 

flg=ax,iw 







B 

mov 

mov 

mov 

mov 

mov 

mov 

mov 

mov 


ax=rw 

cw=iw 

dw=iw 

bw=iw 

sp=iw 

bp=iw 

si=iw 

di=iw 

C 

enter 1 

leave 1 

retf 

retf 

int 3 

int 

into 

iret 


iw.ib 


sp=sp+iw 



ib 



D 

escO 

esc 1 

esc 2 

esc 3 

esc 4 

esc 5 

esc 6 

esc 7 

E 

call near 

jmpnear 

jmpfar 

jmp short 

in 

in 

out 

out 





al.dx 

ax.dx 

dx,al 

dx.al 


F 

clc 

stc 

cli 

sti 

cld 

std 

Table V 

Table V 








rmb 

rmw 


Notes 

v V20/V30 only 3 80386 & 80486 only 

1 V20A/30& 80186 through 80486 4 80486 only 

2 80286 through 80486 only 
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Appendix F: Reference Tables 


Tables S through V 

3 bits from reg field, 2nd Opcode (md-reg-r/m) 


TbI 

000 

001 

010 

011 

100 

101 

110 

111 

S 

add 

or 

adc 

sbb 

and 

sub 

xor 

cmp 

T 

rol 

ror 

rcl 

rcr 

shl / sal 

shr 

shl/sal 1 

sar 

U 

test 

not 

neg 

mul 

imul 

div 

idiv 


V 

inc 

dec 

call near 

call far 

jmp near 

jmp far 




Notes 

v V20/V30 only 3 80386 & 80486 only 

1 V20/V30& 80186 through 80486 4 80486 only 

2 80286 through 80486 only 
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Appendix F: Reference Tables 


Table W: 80286 through 80486 Multi-Byte Opcode Instructions (First Opcode is OFh) 

LOW 


HI 

0 

1 

2 

3 

4 

5 

6 

7 

0 

Table X 2 

Table Y 2 

lar 2 

rw.rmw 

Is I 2 

rw.rmw 



cits 2 


1 









2 









3 









4 









5 









6 









7 









8 

jo 3 

jno 3 

jb 3 

jnb 3 

jz 3 

jnz 3 

jbe 3 

jnbe 3 

9 

seto 3 

rmb 

setno 3 

rmb 

setb 3 

rmb 

setnb 3 

rmb 

setz 3 

rmb 

setnz 3 

rmb 

setbe 3 

rmb 

setnbe 3 

rmb 

A 

push 3 

fs 

pop 3 

fs 


bt 3 

rmw.rw 

shld 3 
rmw.rw, ib 

shld 3 
rmw.rw,cl 



B 



Iss 3 

rw,mw 

btr 3 

rmw.rw 

Its 3 

rw.mw 

Igs 3 

rw.mw 

movzx 3 

rw.rmb 

movzx 3 

rd.rmw 

C 

xadd 4 

rmb.rb 

xadd 4 

rmw.rw 





cmpxchg 4 

rmb.rb 

cmpxchg 4 

rmw.rw 

D 









E 









F 
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LOW 


HI 

8 

9 

A 

B 

C 

D 

E 

F 

0 

invd 4 

wbinvd 4 







1 









2 









3 









4 









5 









6 









7 









8 

js 3 

jns 3 

jP 3 

jnp 3 

f 

jnl 3 

jle 3 

jnle 3 

9 

sets 3 

rmb 

setns 3 

rmb 

setp 3 

rmb 

setnp 3 

rmb 

setl 3 

rmb 

setnl 3 

rmb 

setle 3 

rmb 

setnle 3 

rmb 

A 

push 3 

gs 

pop 3 

gs 


bts 3 

rmw.rw 

shrd 3 
rmw.rw,ib 

shrd 3 
rmw.rw,cl 


imul 3 

rw.rmw 

B 



Table Z 3 

btc 3 

rmw.rw 

bsf 3 

rw.rmw 

bsr 3 

rw.rmw 

it 

movsx 3 

rw.rmb 

C 

bswap 4 

ax 

bswap 4 

cx 

bswap 4 

dx 

bswap 4 

bx 

bswap 4 

sp 

bswap 4 

bp 

bswap 4 

si 

bswap 4 

di 

D 









E 









F 










Notes 

v V20/V30 only 3 80386 & 80486 only 

1 V20/V30& 80186 through 80486 4 80486 only 

2 80286 through 80486 only 
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Appendix F: Reference Tables 


Tables X through Z 

Bits 5, 4, 3 from reg field, 3rd Opcode (md-reg-r/m) 



000 

001 

010 

Oil 

100 

101 

110 

111 

X 

sldt 2 

str 2 

lldt 2 

Itr 2 

verr 2 

verw 2 




rmw 

rmw 

rmw 

rmw 

rmw 

rmw 



Y 

sgdt 2 

sidt 2 

Igdt 2 

lidt 2 

smsw 2 

invlpg 4 

Imsw 2 



mq 

mq 

mq 

mq 

rmw 

m 

rmw 


Z 





bt 3 

bts 3 

btr 3 

btc 3 






rmw.ib 

rmw.ib 

rmw.ib 

rmw.ib 


Notes 

v V20/V30 only 3 80386 & 80486 only 

1 V20/V30& 80186 through 80486 4 80486 only 

2 80286 through 80486 only 
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Character Set Table 


Control 

Hex Dec Codes Hex Dec Hex Dec Hex Dec Hex Dec Hex Dec Hex Dec 


0 

000 

NUL 


20 

032 


40 

064 

% 

60 

096 


80 

128 

s 

AO 

160 

A 

CO 

192 

L 

1 

001 

SOH 


21 

033 

1 

41 

065 

A 

61 

097 

a 

81 

129 

u 

A1 

161 

1 

Cl 

193 

± 

2 

002 

STX 

~B 

22 

034 

* 

42 

066 

B 

62 

098 

b 

82 

130 

6 

A2 

162 

6 

C2 

194 

T 

3 

003 

ETX 


23 

035 

/ 

43 

067 

C 

63 

099 

c 

83 

131 

a 

A3 

163 

0 

C3 

195 

b 

4 

004 

EOT 


24 

036 

$ 

44 

068 

D 

64 

100 

d 

84 

132 

a 

A4 

164 

ft 

C4 

196 


5 

005 

ENQ 


25 

037 

Z 

45 

069 

E 

65 

101 

e 

85 

133 

a 

A5 

165 

ft 

C5 

197 

+ 

6 

006 

ACK 

~F 

26 

038 

& 

46 

070 

F 

66 

102 

f 

86 

134 

a 

A6 

166 

A 

C6 

198 

b 

7 

007 

DEL 


27 

039 

’ 

47 

071 

G 

67 

103 

g 

87 

135 

5 

A7 

167 

Q 

C7 

199 

\[ 

8 

008 

BS 

~H 

28 

040 

( 

48 

072 

H 

68 

104 

h 

88 

136 

§ 

A8 

168 

l 

C8 

200 

ik 

9 

009 

HT 

"I 

29 

041 

) 

49 

073 

I 

69 

105 

i 

89 

137 

a 

A9 

169 

r- 

C9 

201 

Ir 

A 

010 

LF 


2A 

042 

★ 

4A 

074 

J 

6A 

106 

j 

8 A 

138 

a 

AA 

170 


CA 

202 

Jt 

B 

Oil 

VT 


2B 

043 

+ 

4B 

075 

K 

6B 

107 

k 

8B 

139 

i 

AB 

171 

h 

CB 

203 

TT 

C 

012 

FF 


2C 

044 

, 

4C 

076 

L 

6C 

108 

1 

8C 

140 

i 

AC 

172 

k 

CC 

204 

lb 

D 

013 

CR 


2D 

045 

- 

4D 

077 

M 

6D 

109 

m 

8D 

141 

i 

AD 

173 

i 

CD 

205 

= 

E 

014 

SO 


2E 

046 


4E 

078 

N 

6E 

110 

n 

8E 

142 

A 

AE 

174 

« 

CE 

206 

nr 

F 

015 

SI 

~0 

2F 

047 

/ 

4F 

079 

0 

6F 

111 

0 

8F 

143 

A 

AF 

175 

» 

CF 

207 

X 

10 

016 

DLE 


30 

048 

0 

50 

080 

P 

70 

112 

P 

90 

144 

t 

BO 

176 

:: 

DO 

208 

JL 

11 

017 

DC1 

-Q 

31 

049 

1 

51 

081 

Q 

71 

113 

q 

91 

145 

38 

B1 

177 

s 

D1 

209 

T 

12 

018 

DC 2 

~R 

32 

050 

2 

52 

082 

R 

72 

114 

r 

92 

146 

R 

B2 

178 


D2 

210 

TT 

13 

019 

DC 3 

~S 

33 

051 

3 

53 

083 

S 

73 

115 

s 

93 

147 

a 

B3 

179 

1 

D3 

211 

IL 

14 

020 

DC4 


34 

052 

4 

54 

084 

T 

74 

116 

t 

94 

148 

6 

B4 

180 

fl 

D4 

212 

k 

15 

021 

NAK 

~U 

35 

053 

5 

55 

085 

U 

75 

117 

u 

95 

149 

a 

B5 

181 


D5 

213 

F 

16 

022 

SYN 

-v 

36 

054 

6 

56 

086 

V 

76 

118 

V 

96 

150 

fl 

B6 

182 

fl 

D6 

214 

IT 

17 

023 

ETB 


37 

055 

7 

57 

087 

W 

77 

119 

w 

97 

151 

fl 

B7 

183 

n 

D7 

215 

1 

18 

024 

CAN 

"X 

38 

056 

8 

58 

088 

X 

78 

120 

X 

98 

152 

y 

B8 

184 

l 

D8 

216 

+ 

19 

025 

EM 

~Y 

39 

057 

9 

59 

089 

Y 

79 

121 

y 

99 

153 

0 

B9 

185 

fl 

D9 

217 

J 

1A 

026 

SUB 

~Z 

3A 

058 


5A 

090 

Z 

7A 

122 

z 

9A 

154 

t) 

BA 

186 

II 

DA 

218 

r 

IB 

027 

ESC 


3B 

059 

; 

5B 

091 

[ 

7B 

123 

{ 

9B 

155 

$ 

BB 

187 

Tl 

DB 

219 

1 

1C 

028 

FS 


3C 

060 

< 

5C 

092 

\ 

7C 

124 

1 

9C 

156 

£ 

BC 

188 

JJ 

DC 

220 

■ 

ID 

029 

GS 

'll 

3D 

061 

- 

5D 

093 

] 

7D 

125 

} 

9D 

157 

¥ 

BD 

189 

J1 

DD 

221 

1 

IE 

030 

RS 


3E 

062 

> 

5E 

094 


7E 

126 

~ 

9E 

158 

Pi 

BE 

190 

j 

DE 

222 

1 

IF 

031 

US 


3F 

063 

? 

5F 

095 


7F 

127 


9F 

159 

/ 

BF 

191 

1 

DF 

223 

■ 


Hex Dec 


EO 224 a 
El 225 p 
E2 226 T 
E3 227 ir 
E4 228 2 
E5 229 a 
E6 230 \l 
E7 231 t 

E8 232 4> 
E9 233 0 
EA 234 0 
EB 235 8 
EC 236 oo 
ED 237 4> 
EE 238 E 
EP 239 fl 

FO 240 ■ 
Fl 241 ± 
F2 242 * 
F3 243 £ 
F4 244 f 
F5 245 J 
F6 246 - 
F7 247 - 

F8 248 0 
F9 249 • 
FA 250 
FB 251 V 
FC 252 n 
FD 253 * 
FE 254 | 
FF 255 
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Glossary of Abbreviations 


A/D 

Analog to Digital 

b&w 

Black and White (display) 

BIOS 

Basic Input/Output System 

bps 

Bits Per Second 

CGA 

Color Graphics Adapter 

CTS 

Clear To Send (modem control) 

D/A 

Digital to Analog 

DMA 

Direct Memory Access (may refer to DMA IC) 

DSR 

Data Set Ready (modem control) 

DTA 

Disk Transfer Address (software pointer) 

DTR 

Data Terminal Ready (modem control) 

ECC 

Error Checking and Correction 

EGA 

Enhanced Graphics Adapter 

EMS 

Expanded Memory Specification 

EPROM 

Erasable Programmable Read Only Memory 

FCB 

File Control Block (data describing a file) 

I/O 

Input/Output 

IC 

Integrated Circuit 

IMR 

Interrupt Mask Register 

int 

Interrupt 

IRQ 

Interrupt Request 
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Glossary of Abbreviations 


LAN Local Area Network 

LED Light-Emmitting Diode 

MDA Monochrome Display Adapter 

NMI Non-Maskable Interrupt (interrupt 2) 

PEL Pixel (display) 

PSP Program Segment Prefix (program header for DOS) 
POS Programable Option Select (micro-channel) 

POST Power On Self Test 

RAM Random Access Memory 

ROM Read Only Memory (usually EPROMS) 

RTC Real Time Clock 

RTS Request To Send (modem control) 

TSR Terminate and Stay Resident (type of program) 

VGA Video Graphics Array/Adapter 

uP Microprocessor 
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Index 


Symbols 

ASSUME statements 24 

- 9 
/ 9 

;* 28, 70 
> 9 
?? 9 

1 9 

B 

batch mode 38 
beginning segment 37 
block nesting errors 75 

C 

1 

call 

indexed 11,25,51,70 

16-bit segments 45 

register 70 
character set 121 

2 

code 

286 instruction set 16 

forced 73 
inaccessible 73 

3 

incorrect determination 72 

32-bit segments 45 

386 instruction set 16,107 

486 instruction set 16,107 

code style 

COM 14 
device driver 15 

EXE 14 

8 

fragment 14 
overlay 15 

80188/80186 instruction set 16 

80286 instruction set 16 

80386 instruction set 16,107 

80486 instruction set 16,107 

8088/8086 instruction set 16 

setting 13, 37 
zero start 14 

COM code style 14 
command-line options 30 
commands 81 to 83 

A 

selecting 2 
comments 51 

A86 69 

absolute location references 23 
analysis options 17 to 29, 36, 83 to 85 
assembler compatibility 67 to 69 
assemblers 67 to 69,110 

automatic 40 
data items 63 
locations 63 
subroutines 64 
output file 61 to 65 
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Index 


cross-references 

analysis options 27 
data 27 

definition file, setting 42 
format 10 
location 27 
subroutine 27 
customer support 105 


data 

comments 63 
cross-references 27 
forced 72 

incorrect determination 72 
options 48 
reference 48 
types 47 

default settings, system 30, 59 to 60 
definition file 

comment lines 33 

comments to appear in listing 51 

control information 36 to 42 

control options 36 to 42 

defined 33 

forced functions 49 

format 33 

generated by Sourcer 4, 35 
loading 35 
location options 49 
output file comments 61 to 65 
range definition entries 43 
range definitions 42 to 46 
reference definitions 46 to 57 
section one 36 to 42 
section three 46 to 57 
section two 42 to 46 
structure 33 
subroutine options 49 
templates 35 

device driver code style 15 
display 

EGA/VGA 30 
nonstandard 30 

DS register, default value 19, 44 


E 

editors 109 

EGA display problems 30 
entry points 
external 74 
interrupt vectors 22 
equates 8 

error messages 88 to 94 

ES register, default value 19, 44 

Esc key 5 

EXE code style 14 

external entry points 74 

F 

file 

loading 3 
processing 3 

file viewing programs 109 
forced function indicator 57 
forced functions 50 
fragment code style 14 

G 

graphics characters 22 

H 

header for listing 38 
help 81 

illegal size errors 76 
immediate field (within instruction) 
71 

inaccessible code 17, 73 
index register 26 
indexed 

call 11,25,51,70 
data values 21, 28 
jump 11,25, 51, 70 
input file 
loading 3 
processing 3 
input filename 38 
installing Sourcer 1 
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Index 


interrupt vector entry points 22 
invalid segment reference 9 

J 

jump 

indexed 11,25,51,70 
near 28 
register 70 

K 

keeping segment ranges 38 

L 

label 51 
label types 39 
listing file 4 
contents 7 
cross-references 10 
equates 8 

forced function indicator 57 
header 38 

indexed jumps and calls 11 
lines per page 41 
prefixes 9 

width compression 41 
loading a file 3 
location 

absolute references 23 
comments 63 
cross-references 27 
options 49 
reference 49 
lowercase characters 42 

M 

Main Menu 2 

Main Menu commands 81 to 83 
MASM 4.0 23, 68 
MASM 5.0 68 
math coprocessor 39 
messages 88, 94 
microprocessor filter 15 
microprocessor instruction set 41 


N 

near jumps 28 
nonstandard display 30 

O 

opcode decoder table 114 
OPTASM 69 
output commands 31 
output diskdrive 3 
output file 

adding comments 51 
direct to printer 32 
diskdrive 37 
format 3 to 4, 37 
options 31 

output filename 3, 39 
extensions 4 
overlay code style 15 

P 

passes 15, 40 
patching programs 78 
phase errors 75 
prefixes 9 

problems running Sourcer 87 to 94 
processing a file 3 
product support 105 
protected mode 16 

Q 

quitting Sourcer 5 

R 

range definition entries 43 
range definitions 42 to 46 
readme file 96 
readme program 1 
real mode 16 
reassembly errors 74 to 77 
reassembly problems 69 to 74 
reference definition entry 47 
reference definitions 46 to 57 
references, final pass 29 
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Index 


register 
call 70 
jump 70 

remarks file 61 to 65 
data remarks section 63 
location remarks section 63 
subroutine remarks section 64 
RETF instruction 23, 75 
RETN instruction 23, 75 
SAMPLE1.DEF file 35,96 
SAMPLE2.DEF file 35, 96 
SDEFAULT.DEF file 59 to 60, 96 
SDF file 4, 35 
segment 
display 40 
size 45 
types 44 
variables 43 
selecting a command 2 
source code 

changing 77 to 79 
source code file 4 
Sourcer 

applications 1 
commands 81 to 83 
earlier versions 100 
features 98 
files 96 

hardware requirements 96 
how Sourcer works 95 
information program 1 
installing 1 
quitting 5 
specifications 97 
Sourcer information program 1 
Sourcer-generated definition file 4, 35 
spaces in listing 41 
specifications 97 
SR.EXE file 96 
starting Sourcer 2 
status area 4 
subroutine 
comments 64 
cross references 27 
options 49 
reference 49 


terminated 20 
syntax errors 75 

T 

tabs in listing 41 
TASM 69 

terminated subroutine 20 
TSR programs 74 

U 

update policy 105 
uppercase characters 42 

V 

V20/V30 instruction set 16 
VGA display problems 30 
viewing programs 109 

W 

warning message 70 
warning messages 28 

Z 

zero start code style 14 
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License and Warranty Agreement 

This software is protected by both United States copyright law and international treaty provisions. 
This means you must treat this software just like a book. Like a book, this software may be freely 
moved from machine to machine, so long as there is NO POSSIBILITY of the software being used at 
two different places at the same time. This software is NOT SHAREWARE, and may not be 
distributed by bulletin boards or other forms which violate V Communications' copyrights. The 
single exception for duplicating this software is for the sole purpose of backing up our software and 
protecting your investment from loss. 

V Communications Limited Warranty 

V Communications, Inc. warrants the diskettes on which the program is furnished to be free from 
defects in materials and workmanship under normal use, for a period of thirty (30) days from the 
date of delivery to you as evidenced by a copy of your receipt. In the event of notification within the 
warranty period of defects in the material or workmanship, V Communications will exchange the 
diskette. V Communications also warrants that the software conforms substantially with any 

V Communications' advertised claims at the date of sale, for a period of thirty (30) days from the date 
of delivery to you as evidenced by a copy of your receipt. In the event of notification within the 
warranty period of failure to meet any V Communications' advertised claims at the date of sale, you 
may return the program and all associated manuals in good condition to your place of purchase for a 
refund. IF YOU NEED TO EXCHANGE OR RETURN A PRODUCT TO V COMMUNICATIONS, 
CALL OUR CUSTOMER SERVICE DEPARTMENT TO OBTAIN A RETURN AUTHORIZATION 
NUMBER. The sole remedy for breach of this warranty shall be limited to replacement or refund and 
shall not encompass any other damages, including but not limited to loss of profit, and incidental, 
consequential, or other similar claims. Refunds do not include any portion of shipping and handling, 
or special shipping fees such as COD costs, etc. 

Limitation of Remedies 

V Communications, Inc. specifically disclaims all other warranties, expressed or implied, including 
but not limited to implied warranties of merchantability and fitness for a particular purpose with 
respects to defects in the diskette or documentation, and the program license granted herein in 
particular, and without limiting operation of the program license with respect to any particular 
application, use, or purpose. In no event shall V Communications be liable for any loss of profit or 
any other damages, including but not limited to incidental, consequential, or other damages. 

Complete Agreement 

Having read this Agreement, you agree that no contrary or inconsistent statement, oral or written, 
has ben made by any person and that this is the complete and exclusive statement of the terms and 
conditions of the Agreement between us, and any prior proposal or statement, whether oral or 
written, is superseded. In the event of any dispute regarding the terms and conditions of the 
Agreement, you agree that the laws of the State of California will govern the interpretation of the 
Agreement. 
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